loopengine 0.1.15 → 0.1.24

package/dist/core/toollane.d.ts

@@ -0,0 +1,46 @@
+/** A tool call is just a callable with identity — this module doesn't
+ * know or care what a "tool" is beyond that. */
+export interface ToolCall {
+    id: string;
+    name: string;
+    execute: () => Promise<unknown>;
+}
+/** Host-provided: does this specific call belong in a parallel lane?
+ * Mirrors Claude Code's own isReadOnly()/isConcurrencySafe() per-tool
+ * declarations. */
+export type SafetyClassifier = (call: ToolCall) => boolean;
+export interface Lane {
+    mode: 'parallel' | 'solo';
+    calls: ToolCall[];
+}
+export interface LaneResult {
+    id: string;
+    name: string;
+    status: 'fulfilled' | 'rejected';
+    value?: unknown;
+    error?: unknown;
+}
+/** Groups a batch of tool calls into lanes: consecutive safety-declared
+ * calls merge into one parallel lane; anything else gets its own solo
+ * lane. Batch order is preserved across lanes — this never reorders
+ * calls, only decides what runs together. */
+export declare function buildLanes(calls: ToolCall[], isSafe: SafetyClassifier): Lane[];
+/** Runs lanes in order; calls within a parallel lane run concurrently.
+ * Every call resolves to a LaneResult regardless of success or failure —
+ * one call throwing never rejects the batch, it just carries the error
+ * in its own slot. */
+export declare function runLanes(lanes: Lane[]): AsyncGenerator<LaneResult>;
+export interface ToolLaneOptions {
+    isSafe: SafetyClassifier;
+}
+/** Ties classification, scheduling, and execution together: given a
+ * batch of approved tool calls, decide a safe execution plan and run
+ * it, streaming each call's result as it completes. */
+export declare class ToolLane {
+    private readonly isSafe;
+    constructor(options: ToolLaneOptions);
+    /** Read-only — returns the lane plan without executing anything. */
+    plan(calls: ToolCall[]): Lane[];
+    /** Builds the plan and executes it. */
+    run(calls: ToolCall[]): AsyncGenerator<LaneResult>;
+}

package/dist/core/toollane.js

@@ -0,0 +1,69 @@
+// Formerly the standalone `toollane` package — folded in here for the
+// same reason mcpplug.ts was: no consumer besides loopengine itself ever
+// actually materialized, so the separate-package/portable-to-any-host
+// framing was aspirational rather than realized. A concurrency-safety-
+// aware scheduler for a batch of already-approved tool calls: consecutive
+// safety-declared calls run together in a parallel lane, anything else
+// gets its own solo lane, order preserved, one failure isolated to its
+// own slot rather than rejecting the whole batch.
+/** Groups a batch of tool calls into lanes: consecutive safety-declared
+ * calls merge into one parallel lane; anything else gets its own solo
+ * lane. Batch order is preserved across lanes — this never reorders
+ * calls, only decides what runs together. */
+export function buildLanes(calls, isSafe) {
+    const lanes = [];
+    for (const call of calls) {
+        const safe = isSafe(call);
+        const lastLane = lanes.at(-1);
+        if (safe && lastLane?.mode === 'parallel') {
+            lastLane.calls.push(call);
+            continue;
+        }
+        lanes.push({ mode: safe ? 'parallel' : 'solo', calls: [call] });
+    }
+    return lanes;
+}
+async function runCall(call) {
+    try {
+        const value = await call.execute();
+        return { id: call.id, name: call.name, status: 'fulfilled', value };
+    }
+    catch (error) {
+        return { id: call.id, name: call.name, status: 'rejected', error };
+    }
+}
+/** Runs lanes in order; calls within a parallel lane run concurrently.
+ * Every call resolves to a LaneResult regardless of success or failure —
+ * one call throwing never rejects the batch, it just carries the error
+ * in its own slot. */
+export async function* runLanes(lanes) {
+    for (const lane of lanes) {
+        if (lane.mode === 'solo') {
+            const call = lane.calls[0];
+            if (call)
+                yield await runCall(call);
+            continue;
+        }
+        const results = await Promise.all(lane.calls.map(runCall));
+        for (const result of results) {
+            yield result;
+        }
+    }
+}
+/** Ties classification, scheduling, and execution together: given a
+ * batch of approved tool calls, decide a safe execution plan and run
+ * it, streaming each call's result as it completes. */
+export class ToolLane {
+    isSafe;
+    constructor(options) {
+        this.isSafe = options.isSafe;
+    }
+    /** Read-only — returns the lane plan without executing anything. */
+    plan(calls) {
+        return buildLanes(calls, this.isSafe);
+    }
+    /** Builds the plan and executes it. */
+    async *run(calls) {
+        yield* runLanes(this.plan(calls));
+    }
+}

package/dist/index.d.ts

@@ -6,6 +6,10 @@ export { streamMessage, streamMessageWithCallbacks, sendMessage, approveCall, de
 export type { RequestOptions, SendMessageResult, PendingApprovalResult, PendingQuestionResult, PendingResult, MessageResult, StreamMessageCallbacks, } from './core/client.js';
 export { FileSessionStore, RedisSessionStore, createSessionStore } from './core/session-store.js';
 export type { SessionStore, SessionResult, RedisSessionStoreOptions } from './core/session-store.js';
+export { SessionKnit, FileStorage, MemoryStorage, reconstructChain } from './core/sessionknit.js';
+export type { Storage, SessionEntry, ResumeResult, SessionKnitOptions, ReconstructResult } from './core/sessionknit.js';
+export { SkillGarden, parseSkillFile, discoverSkillFiles, estimateTokens as estimateSkillIndexTokens, buildBudgetedIndex, substituteArguments, matchesActivationPaths, } from './core/skillgarden/index.js';
+export type { SkillGardenOptions, SkillFrontmatter, SkillIndexEntry, LoadedSkill, DiscoveredSkillFile, BuildIndexOptions, BudgetedIndex, } from './core/skillgarden/index.js';
 export { VectorIndex, embed, cosineSimilarity } from './core/vector-index.js';
 export type { Document, ScoredDocument } from './core/vector-index.js';
 export { createAnthropicModelCall } from './core/model-calls/anthropic-model-call.js';
@@ -32,6 +36,10 @@ export { createCheckpointStore } from './core/durable-approvals.js';
 export type { TurnCheckpoint, CheckpointStore, OutstandingItem } from './core/durable-approvals.js';
 export { addGatewayTool, agentDir, disconnectComposioAccount, describeGatewayTools, listComposioConnections, listComposioTools, loadGatewayToolsFromDir, removeGatewayTool, removeGatewayToolSlug, GatewayToolExistsError, GatewayToolNotFoundError, } from './core/gateway-tools.js';
 export type { GatewayToolEntry, GatewayToolDecision } from './core/gateway-tools.js';
+export { connectComposioSource } from './core/mcpplug.js';
+export type { ToolSource, ComposioSourceOptions } from './core/mcpplug.js';
+export { ToolLane, buildLanes, runLanes } from './core/toollane.js';
+export type { ToolLaneOptions, SafetyClassifier, ToolCall, Lane, LaneResult } from './core/toollane.js';
 export { WebhookNotifier } from './core/http-notify-triggers/webhook.js';
 export { listQuestions, answerQuestion as resolvePendingQuestion, findQuestion, createAskUserTool } from './core/system-tools/index.js';
 export type { PendingQuestion } from './core/system-tools/index.js';
@@ -45,8 +53,6 @@ export { globalConfigPageHtml } from './web/global-config-page.js';
 export { playgroundHtml } from './web/playground.js';
 export { readSkill, writeSkill, deleteSkill, SkillInvalidIdError, SkillNotFoundError } from './web/skills-admin.js';
 export type { SkillContent } from './web/skills-admin.js';
-export { listSkillgardenCatalog, readSkillgardenCatalogEntry, addSkillgardenSkillToAgent, SkillgardenUnavailableError } from './web/skillgarden-admin.js';
-export type { SkillgardenCatalogEntry, SkillgardenCatalogDetail } from './web/skillgarden-admin.js';
 export { listDeclaredEnvVars, setEnvVar, EnvVarNameError } from './web/env-admin.js';
 export type { DeclaredEnvVar } from './web/env-admin.js';
 export { readActauthConfig, addActauthRule, updateActauthRule, removeActauthRule, setDefaultDecision, ActauthRuleExistsError, ActauthRuleNotFoundError, } from './web/actauth-admin.js';

package/dist/index.js

@@ -12,6 +12,8 @@ export { runAgent } from '#core/run-agent.js';
 // exception.
 export { streamMessage, streamMessageWithCallbacks, sendMessage, approveCall, denyCall, answerQuestion, getSessionHistory, } from './core/client.js';
 export { FileSessionStore, RedisSessionStore, createSessionStore } from './core/session-store.js';
+export { SessionKnit, FileStorage, MemoryStorage, reconstructChain } from './core/sessionknit.js';
+export { SkillGarden, parseSkillFile, discoverSkillFiles, estimateTokens as estimateSkillIndexTokens, buildBudgetedIndex, substituteArguments, matchesActivationPaths, } from './core/skillgarden/index.js';
 export { VectorIndex, embed, cosineSimilarity } from './core/vector-index.js';
 export { createAnthropicModelCall } from './core/model-calls/anthropic-model-call.js';
 export { createOpenAIModelCall } from './core/model-calls/openai-model-call.js';
@@ -33,6 +35,8 @@ export { Compactor, TruncatingSummarizer } from './core/compaction.js';
 export { LLMSummarizer } from './core/llm-summarizer.js';
 export { createCheckpointStore } from './core/durable-approvals.js';
 export { addGatewayTool, agentDir, disconnectComposioAccount, describeGatewayTools, listComposioConnections, listComposioTools, loadGatewayToolsFromDir, removeGatewayTool, removeGatewayToolSlug, GatewayToolExistsError, GatewayToolNotFoundError, } from './core/gateway-tools.js';
+export { connectComposioSource } from './core/mcpplug.js';
+export { ToolLane, buildLanes, runLanes } from './core/toollane.js';
 export { WebhookNotifier } from './core/http-notify-triggers/webhook.js';
 // answerQuestion above (core/client.ts) is the HTTP client-side helper —
 // this is the server-side function that actually resolves a pending
@@ -45,7 +49,6 @@ export { agentsListPageHtml } from './web/agents-list-page.js';
 export { globalConfigPageHtml } from './web/global-config-page.js';
 export { playgroundHtml } from './web/playground.js';
 export { readSkill, writeSkill, deleteSkill, SkillInvalidIdError, SkillNotFoundError } from './web/skills-admin.js';
-export { listSkillgardenCatalog, readSkillgardenCatalogEntry, addSkillgardenSkillToAgent, SkillgardenUnavailableError } from './web/skillgarden-admin.js';
 export { listDeclaredEnvVars, setEnvVar, EnvVarNameError } from './web/env-admin.js';
 export { readActauthConfig, addActauthRule, updateActauthRule, removeActauthRule, setDefaultDecision, ActauthRuleExistsError, ActauthRuleNotFoundError, } from './web/actauth-admin.js';
 export { describeModelProviders, describeGateways } from './web/global-config.js';

package/dist/web/agents-config-page.js

@@ -367,26 +367,6 @@ export const agentsConfigPageHtml = `<!doctype html>
   #httpToolAddFieldBtn, #httpToolAddHeaderBtn {
     padding: 6px 12px;
   }
-  .skillgarden-category-badge {
-    display: inline-block;
-    font-family: ui-sans-serif, system-ui, sans-serif;
-    font-size: 10px;
-    font-weight: 600;
-    text-transform: uppercase;
-    letter-spacing: 0.03em;
-    padding: 1px 7px;
-    border-radius: 999px;
-    background: light-dark(#eef1ec, #1e2519);
-    color: light-dark(#3f6b4a, #7fbf8f);
-    margin-right: 6px;
-  }
-  #skillgardenFilterInput { margin-bottom: 8px; }
-  .skillgarden-catalog-body {
-    margin-top: 8px;
-    padding-top: 8px;
-    border-top: 1px solid light-dark(#eee, #2a2a2e);
-    font-size: 13px;
-  }
 </style>
 </head>
 <body>
@@ -1130,9 +1110,9 @@ export const agentsConfigPageHtml = `<!doctype html>
       });
   }
 
-  // ---- Environment tab: every env var a package (see PACKAGES.md,
-  // bin/package-manager.ts) declared it needs for this agent, across
-  // every package installed — status only, a value is never shown once
+  // ---- Environment tab: every env var an ability (see ABILITIES.md,
+  // bin/ability-manager.ts) declared it needs for this agent, across
+  // every ability installed — status only, a value is never shown once
   // set, matching env-admin.ts's own never-echo-a-secret rule. Lazily
   // loaded the same way Actauth is, for the same reason (avoid a
   // redundant fetch on every agent switch for a tab that isn't always
@@ -1146,7 +1126,7 @@ export const agentsConfigPageHtml = `<!doctype html>
     return '<tr>' +
       '<td><code>' + escapeHtml(v.name) + '</code></td>' +
       '<td>' + escapeHtml(v.description || '') + '</td>' +
-      '<td class="hint">' + escapeHtml(v.packageName) + '</td>' +
+      '<td class="hint">' + escapeHtml(v.abilityName) + '</td>' +
       '<td>' + (v.set ? '<span class="hint">set</span>' : '<span class="error">not set</span>') + '</td>' +
       '<td><form class="add-source env-var-form" data-name="' + escapeHtml(v.name) + '">' +
         '<input type="' + (v.secret ? 'password' : 'text') + '" name="value" placeholder="' + (v.set ? 'unchanged unless you type a new value' : 'value') + '" required>' +
@@ -1156,9 +1136,9 @@ export const agentsConfigPageHtml = `<!doctype html>
   }
 
   function renderEnvConfigHtml(vars) {
-    if (!vars.length) return '<p class="hint">No installed package has declared any environment variables for this agent yet.</p>';
+    if (!vars.length) return '<p class="hint">No installed ability has declared any environment variables for this agent yet.</p>';
     var rows = vars.map(renderEnvRow).join('');
-    return '<table><thead><tr><th>Name</th><th>Description</th><th>Package</th><th>Status</th><th>Set value</th></tr></thead><tbody>' + rows + '</tbody></table>';
+    return '<table><thead><tr><th>Name</th><th>Description</th><th>Ability</th><th>Status</th><th>Set value</th></tr></thead><tbody>' + rows + '</tbody></table>';
   }
 
   function envContentEl() {
@@ -1270,194 +1250,18 @@ export const agentsConfigPageHtml = `<!doctype html>
           '<button type="submit" id="skillSubmitBtn">Add</button>' +
           '<button type="button" id="skillCancelBtn" style="display:none">Cancel</button>' +
           '<div id="skillFormError" class="error"></div>' +
-        '</form></section>' +
-      '<section><h3>Browse skillgarden catalog</h3>' +
-        '<input type="text" id="skillgardenFilterInput" placeholder="Filter by name or category&hellip;">' +
-        '<div id="skillgardenCatalogList"><p class="hint">Loading&hellip;</p></div>' +
-      '</section>';
+        '</form></section>';
   }
 
   function skillsPanelEl() {
     return detail.querySelector('[data-tab-panel="skills"]');
   }
 
-  // ---- Skills tab's "Browse skillgarden catalog" section: a
-  // read-only, agent-independent list of everything GET /skillgarden-
-  // catalog reports (see web/skillgarden-admin.ts) — cached in this one
-  // module-level variable, not per-agent like gatewayLoadedFor, since
-  // the catalog itself never varies by agent. renderSkillsTabHtml
-  // regenerates the whole Skills panel (including this section's own
-  // markup) on every agent switch/refresh, so loadSkillgardenCatalogSection
-  // re-renders from this cache instead of re-fetching every time — only
-  // the very first time this tab is opened in the page's lifetime hits
-  // the network at all. ----
-  var skillgardenCatalog = null;
-
-  function skillgardenCatalogListEl() {
-    var panel = skillsPanelEl();
-    return panel ? panel.querySelector('#skillgardenCatalogList') : null;
-  }
-
-  function renderSkillgardenCatalogEntry(entry) {
-    return '<div class="source" data-category="' + escapeHtml(entry.category) + '" data-id="' + escapeHtml(entry.id) + '">' +
-      '<div class="source-head">' +
-        '<h4><span class="skillgarden-category-badge">' + escapeHtml(entry.category) + '</span>' + escapeHtml(entry.id) + '</h4>' +
-        '<span>' +
-          '<button type="button" class="skillgarden-view-btn" data-category="' + escapeHtml(entry.category) + '" data-id="' + escapeHtml(entry.id) + '">View</button> ' +
-          '<button type="button" class="skillgarden-add-btn" data-category="' + escapeHtml(entry.category) + '" data-id="' + escapeHtml(entry.id) + '">Add to this agent</button>' +
-        '</span>' +
-      '</div>' +
-      '<p class="hint">' + escapeHtml(entry.description) + '</p>' +
-      '<div class="skillgarden-catalog-body" style="display:none"></div>' +
-      '</div>';
-  }
-
-  function renderSkillgardenCatalogList(entries) {
-    return entries.length ? entries.map(renderSkillgardenCatalogEntry).join('') : '<p class="hint">No skills match.</p>';
-  }
-
-  function applySkillgardenCatalog(name, entries) {
-    var listEl = skillgardenCatalogListEl();
-    if (!listEl) return;
-    listEl.innerHTML = renderSkillgardenCatalogList(entries);
-    wireSkillgardenCatalogHandlers(name);
-  }
-
-  function filteredSkillgardenCatalog(filterText) {
-    if (!filterText) return skillgardenCatalog;
-    var needle = filterText.toLowerCase();
-    return skillgardenCatalog.filter(function (entry) {
-      return entry.category.toLowerCase().indexOf(needle) !== -1 || entry.id.toLowerCase().indexOf(needle) !== -1;
-    });
-  }
-
-  function loadSkillgardenCatalogSection(name) {
-    var listEl = skillgardenCatalogListEl();
-    if (!listEl) return;
-    if (skillgardenCatalog) {
-      var panel = skillsPanelEl();
-      var filterInput = panel ? panel.querySelector('#skillgardenFilterInput') : null;
-      applySkillgardenCatalog(name, filteredSkillgardenCatalog(filterInput ? filterInput.value.trim() : ''));
-      return;
-    }
-    listEl.innerHTML = '<p class="hint">Loading&hellip;</p>';
-    fetch('/skillgarden-catalog')
-      .then(function (r) { return r.json().then(function (j) { return { ok: r.ok, body: j }; }); })
-      .then(function (result) {
-        if (!result.ok) throw new Error(result.body.error || 'request failed');
-        skillgardenCatalog = result.body;
-        if (currentName !== name) return;
-        applySkillgardenCatalog(name, skillgardenCatalog);
-      })
-      .catch(function (err) {
-        if (currentName !== name) return;
-        listEl.innerHTML = '<p class="error">Could not load skillgarden catalog: ' + escapeHtml(err.message) + '</p>';
-      });
-  }
-
-  // force=true retries as an explicit overwrite after the operator
-  // confirms — same "ask once a plain add collides, don't ask up front"
-  // flow the rest of this page never has to think about since nothing
-  // else lets an operator add something whose id they don't already
-  // control the uniqueness of themselves.
-  function performSkillgardenAdd(name, category, id, btn, originalText, force) {
-    fetch('/agents/' + encodeURIComponent(name) + '/skillgarden-catalog/' + encodeURIComponent(category) + '/' + encodeURIComponent(id), {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ force: !!force }),
-    })
-      .then(function (r) { return r.json().then(function (j) { return { ok: r.ok, body: j }; }); })
-      .then(function (result) {
-        if (result.ok) {
-          refreshSkillsDependentPanels(name);
-          return;
-        }
-        if (!force && /already exists/.test(result.body.error || '')) {
-          if (confirm('A skill named "' + id + '" already exists for this agent. Overwrite it?')) {
-            performSkillgardenAdd(name, category, id, btn, originalText, true);
-            return;
-          }
-          btn.disabled = false;
-          btn.textContent = originalText;
-          return;
-        }
-        throw new Error(result.body.error || 'request failed');
-      })
-      .catch(function (err) {
-        alert('Could not add "' + id + '": ' + err.message);
-        btn.disabled = false;
-        btn.textContent = originalText;
-      });
-  }
-
-  function wireSkillgardenCatalogHandlers(name) {
-    var listEl = skillgardenCatalogListEl();
-    if (!listEl) return;
-
-    var viewButtons = listEl.querySelectorAll('.skillgarden-view-btn');
-    for (var i = 0; i < viewButtons.length; i++) {
-      viewButtons[i].addEventListener('click', function (ev) {
-        var btn = ev.currentTarget;
-        var category = btn.getAttribute('data-category');
-        var id = btn.getAttribute('data-id');
-        var card = btn.closest('.source');
-        var bodyEl = card.querySelector('.skillgarden-catalog-body');
-        if (bodyEl.style.display !== 'none') {
-          bodyEl.style.display = 'none';
-          btn.textContent = 'View';
-          return;
-        }
-        if (bodyEl.getAttribute('data-loaded') === '1') {
-          bodyEl.style.display = 'block';
-          btn.textContent = 'Hide';
-          return;
-        }
-        btn.disabled = true;
-        fetch('/skillgarden-catalog/' + encodeURIComponent(category) + '/' + encodeURIComponent(id))
-          .then(function (r) { return r.json().then(function (j) { return { ok: r.ok, body: j }; }); })
-          .then(function (result) {
-            if (!result.ok) throw new Error(result.body.error || 'request failed');
-            bodyEl.innerHTML = renderMarkdownPreview(result.body.body);
-            bodyEl.setAttribute('data-loaded', '1');
-            bodyEl.style.display = 'block';
-            btn.textContent = 'Hide';
-          })
-          .catch(function (err) {
-            bodyEl.innerHTML = '<p class="error">' + escapeHtml(err.message) + '</p>';
-            bodyEl.style.display = 'block';
-          })
-          .then(function () { btn.disabled = false; });
-      });
-    }
-
-    var addButtons = listEl.querySelectorAll('.skillgarden-add-btn');
-    for (var j = 0; j < addButtons.length; j++) {
-      addButtons[j].addEventListener('click', function (ev) {
-        var btn = ev.currentTarget;
-        var category = btn.getAttribute('data-category');
-        var id = btn.getAttribute('data-id');
-        var originalText = btn.textContent;
-        btn.disabled = true;
-        btn.textContent = 'Adding…';
-        performSkillgardenAdd(name, category, id, btn, originalText, false);
-      });
-    }
-  }
-
   function wireSkillsHandlers(name) {
     var panel = skillsPanelEl();
     if (!panel) return;
     var editingSkillId = null;
 
-    loadSkillgardenCatalogSection(name);
-    var skillgardenFilterInput = panel.querySelector('#skillgardenFilterInput');
-    if (skillgardenFilterInput) {
-      skillgardenFilterInput.addEventListener('input', function () {
-        if (!skillgardenCatalog) return;
-        applySkillgardenCatalog(name, filteredSkillgardenCatalog(skillgardenFilterInput.value.trim()));
-      });
-    }
-
     // Write/Preview toggle for the Body field — same idea as GitHub's own
     // issue/PR editor: the textarea and the rendered preview show/hide
     // each other, the textarea's value is the only source of truth (the

package/dist/web/env-admin.d.ts

@@ -4,13 +4,13 @@ export interface DeclaredEnvVar {
     name: string;
     description?: string;
     secret: boolean;
-    packageName: string;
+    abilityName: string;
     set: boolean;
 }
-/** Every env var any package installed for `agentName` declared it
- * needs, deduplicated by name — PACKAGES.md's own open question on
- * cross-package name collisions applies here too (one .env per
- * *project*, not per agent, so two unrelated packages declaring the
+/** Every env var any ability installed for `agentName` declared it
+ * needs, deduplicated by name — ABILITIES.md's own open question on
+ * cross-ability name collisions applies here too (one .env per
+ * *project*, not per agent, so two unrelated abilities declaring the
  * same name can't actually be told apart; the first one seen wins the
  * description shown). `set` is read live off `process.env`, not cached,
  * so it reflects whatever the last `setEnvVar` call — or a plain
@@ -19,7 +19,7 @@ export declare function listDeclaredEnvVars(agentName: string): DeclaredEnvVar[]
 /** Upserts `NAME=VALUE` into the project's `.env` file — preserving
  * every other line (comments, blank lines, unrelated keys) — and
  * applies it to *this* running process immediately via `process.env`,
- * so a newly-installed package's tools work without a restart. Callers
+ * so a newly-installed ability's tools work without a restart. Callers
  * (the PUT route in adapters/http.ts) are responsible for refusing to
  * call this at all when `LOOPENGINE_ADMIN_AUTH` isn't set — this
  * function itself has no notion of HTTP auth, it just writes. */

package/dist/web/env-admin.js

@@ -1,6 +1,6 @@
-// Backs the Admin UI's "Environment" section — every env var a package
-// (see PACKAGES.md, bin/package-manager.ts) declared as required,
-// across every package installed for an agent, with set/not-set status
+// Backs the Admin UI's "Environment" section — every env var an ability
+// (see ABILITIES.md, bin/ability-manager.ts) declared as required,
+// across every ability installed for an agent, with set/not-set status
 // only. A value marked `secret` is never echoed back once set — same
 // never-echo-a-secret rule web/http-tool-admin.ts's own `{{ENV_VAR}}`
 // header handling already establishes for a tool's own secrets.
@@ -13,12 +13,12 @@ export class EnvVarNameError extends Error {
 // validates a {{ENV_VAR}} header reference against.
 const ENV_VAR_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
 function provenancePath(agentName) {
-    return join(agentDir(agentName), '.loopengine-packages.json');
+    return join(agentDir(agentName), '.loopengine-abilities.json');
 }
-/** Every env var any package installed for `agentName` declared it
- * needs, deduplicated by name — PACKAGES.md's own open question on
- * cross-package name collisions applies here too (one .env per
- * *project*, not per agent, so two unrelated packages declaring the
+/** Every env var any ability installed for `agentName` declared it
+ * needs, deduplicated by name — ABILITIES.md's own open question on
+ * cross-ability name collisions applies here too (one .env per
+ * *project*, not per agent, so two unrelated abilities declaring the
  * same name can't actually be told apart; the first one seen wins the
  * description shown). `set` is read live off `process.env`, not cached,
  * so it reflects whatever the last `setEnvVar` call — or a plain
@@ -30,7 +30,7 @@ export function listDeclaredEnvVars(agentName) {
     const provenance = JSON.parse(readFileSync(path, 'utf8'));
     const seen = new Set();
     const result = [];
-    for (const [packageName, record] of Object.entries(provenance)) {
+    for (const [abilityName, record] of Object.entries(provenance)) {
         for (const decl of record.env) {
             if (seen.has(decl.name))
                 continue;
@@ -39,7 +39,7 @@ export function listDeclaredEnvVars(agentName) {
                 name: decl.name,
                 description: decl.description,
                 secret: decl.secret === true,
-                packageName,
+                abilityName,
                 set: process.env[decl.name] !== undefined,
             });
         }
@@ -68,7 +68,7 @@ function serializeEnvValue(value) {
 /** Upserts `NAME=VALUE` into the project's `.env` file — preserving
  * every other line (comments, blank lines, unrelated keys) — and
  * applies it to *this* running process immediately via `process.env`,
- * so a newly-installed package's tools work without a restart. Callers
+ * so a newly-installed ability's tools work without a restart. Callers
  * (the PUT route in adapters/http.ts) are responsible for refusing to
  * call this at all when `LOOPENGINE_ADMIN_AUTH` isn't set — this
  * function itself has no notion of HTTP auth, it just writes. */

package/dist/web/http-tool-admin.d.ts

@@ -40,9 +40,9 @@ export declare function toCamelCase(snakeCase: string): string;
 export declare function addToolToIndex(toolsIndexPath: string, toolFileName: string, exportName: string): void;
 /** addToolToIndex's own undo — removes the named tool's import line and
  * array entry. Best-effort, not "refuse rather than guess" like
- * addToolToIndex: this only ever runs against a tool package-manager.ts
+ * addToolToIndex: this only ever runs against a tool ability-manager.ts
  * itself installed (so the exact shape addToolToIndex wrote is known),
- * and the caller (removePackage) has already deleted the tool's .ts
+ * and the caller (removeAbility) has already deleted the tool's .ts
  * file — leaving a stale entry behind, the previous behavior, means a
  * dangling import that fails the next build, which is strictly worse
  * than a no-op here if the file turns out not to match (hand-edited

package/dist/web/http-tool-admin.js

@@ -191,8 +191,8 @@ export function addToolToIndex(toolsIndexPath, toolFileName, exportName) {
     if (!arrayMatch) {
         throw new HttpToolIndexShapeError(`${toolsIndexPath} doesn't match the expected "export const tools: ToolDefinition[] = [...]" shape — add this tool to it by hand instead.`);
     }
-    // Idempotent — a caller that adds the same tool twice (e.g. package-
-    // manager.ts's removePackage not having cleaned up this same file
+    // Idempotent — a caller that adds the same tool twice (e.g. ability-
+    // manager.ts's removeAbility not having cleaned up this same file
     // before a re-add, or simply calling this twice by mistake) gets a
     // no-op the second time instead of a duplicate `import { X }`
     // declaration, which is a TypeScript syntax error ("Duplicate
@@ -213,9 +213,9 @@ export function addToolToIndex(toolsIndexPath, toolFileName, exportName) {
 }
 /** addToolToIndex's own undo — removes the named tool's import line and
  * array entry. Best-effort, not "refuse rather than guess" like
- * addToolToIndex: this only ever runs against a tool package-manager.ts
+ * addToolToIndex: this only ever runs against a tool ability-manager.ts
  * itself installed (so the exact shape addToolToIndex wrote is known),
- * and the caller (removePackage) has already deleted the tool's .ts
+ * and the caller (removeAbility) has already deleted the tool's .ts
  * file — leaving a stale entry behind, the previous behavior, means a
  * dangling import that fails the next build, which is strictly worse
  * than a no-op here if the file turns out not to match (hand-edited

package/dist/web/skills-admin.js

@@ -11,7 +11,7 @@
 // only adding/editing/removing one through this UI is out of scope.
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { parseSkillFile } from 'skillgarden';
+import { parseSkillFile } from '../core/skillgarden/index.js';
 import { agentDir } from '../core/gateway-tools.js';
 export class SkillInvalidIdError extends Error {
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.1.15",
+  "version": "0.1.24",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",
@@ -23,8 +23,8 @@
     "dist/index.d.ts",
     "dist/bin/cli.js",
     "dist/bin/cli.d.ts",
-    "dist/bin/package-manager.js",
-    "dist/bin/package-manager.d.ts",
+    "dist/bin/ability-manager.js",
+    "dist/bin/ability-manager.d.ts",
     "dist/core/run-agent.js",
     "dist/core/run-agent.d.ts",
     "dist/core/loop-events.js",
@@ -55,6 +55,12 @@
     "dist/core/agent-as-tool.d.ts",
     "dist/core/gateway-tools.js",
     "dist/core/gateway-tools.d.ts",
+    "dist/core/mcpplug.js",
+    "dist/core/mcpplug.d.ts",
+    "dist/core/toollane.js",
+    "dist/core/toollane.d.ts",
+    "dist/core/sessionknit.js",
+    "dist/core/sessionknit.d.ts",
     "dist/core/budget.js",
     "dist/core/budget.d.ts",
     "dist/core/compaction.js",
@@ -68,6 +74,7 @@
     "dist/core/http-notify-triggers",
     "dist/core/system-tools",
     "dist/core/system-skills",
+    "dist/core/skillgarden",
     "dist/core/durable-approvals.js",
     "dist/core/durable-approvals.d.ts",
     "dist/web",
@@ -85,12 +92,8 @@
     "@anthropic-ai/sdk": "^0.116.0",
     "actauth": "^0.0.12",
     "ioredis": "^6.0.0",
-    "mcpplug": "^0.0.1",
     "openai": "^7.4.0",
     "semver": "^7.8.5",
-    "sessionknit": "^0.0.2",
-    "skillgarden": "^0.0.9",
-    "toollane": "^0.0.1",
     "typescript": "^5.7.0",
     "yaml": "^2.6.0"
   },

package/dist/web/skillgarden-admin.d.ts

@@ -1,24 +0,0 @@
-export declare class SkillgardenUnavailableError extends Error {
-}
-export interface SkillgardenCatalogEntry {
-    category: string;
-    id: string;
-    description: string;
-}
-export interface SkillgardenCatalogDetail extends SkillgardenCatalogEntry {
-    body: string;
-}
-export declare function listSkillgardenCatalog(): SkillgardenCatalogEntry[];
-export declare function readSkillgardenCatalogEntry(category: string, id: string): SkillgardenCatalogDetail;
-/** Copies `registry/<category>/<id>/` into `agents/<agentName>/skills/<id>/`
- * — delegates entirely to skillgarden's own `addSkill`, which already
- * knows this exact `agents/<agent>/skills` destination convention (see
- * its own doc comment) and already refuses (or, with `force`,
- * overwrites) an existing destination. Returns the bare skill id actually
- * installed — never category-qualified, matching `addSkill`'s own
- * "category is a registry-organization concept, not forced onto what a
- * caller now owns" convention. */
-export declare function addSkillgardenSkillToAgent(agentName: string, category: string, id: string, force?: boolean): {
-    id: string;
-    path: string;
-};