@stratusagent/cli 0.13.6 → 0.13.7

package/dist/plugin-index.d.ts.map

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

package/dist/plugin-index.js

@@ -0,0 +1,293 @@
+import { readFileSync } from 'node:fs';
+import { isPackageName, parsePluginManifest, PLUGIN_MANIFEST_VERSION } from '@stratusagent/plugins';
+import { isInstallableSpecifier, runNpm } from "./npm.js";
+/**
+ * The curated plugin index: the plugins that release on their own, apart
+ * from this CLI, which setup's Plugins menu can offer under "More plugins".
+ *
+ * The packages released with the CLI are not in it. They are listed in
+ * `plugin-catalog.ts`, always match this CLI, and are already rows of the
+ * menu. The index is for everything else: `stratuslabs/plugins` and,
+ * once there are some, third-party plugins someone has reviewed.
+ *
+ * It is data in `stratuslabs/plugins`, published to npm as
+ * `@stratusagent/plugin-index`, with the list in a `stratusPluginIndex`
+ * field of that package's package.json. npm because the repository is
+ * private and npm is already the registry setup installs from, so no new
+ * host is involved; and a field rather than a file because `npm view`
+ * returns package.json fields without downloading anything.
+ *
+ * The index decides what setup *suggests*, never what it trusts or what a
+ * plugin contributes: that is read from the plugin's own release, and
+ * setup still asks before enabling anything.
+ */
+export const PLUGIN_INDEX_PACKAGE = '@stratusagent/plugin-index';
+export const PLUGIN_INDEX_FIELD = 'stratusPluginIndex';
+export const PLUGIN_INDEX_SCHEMA_VERSION = 1;
+/**
+ * The index as it was when this CLI was released: what setup shows when npm
+ * has no index or cannot be reached. Keep it equal to `index/package.json`
+ * in `stratuslabs/plugins` at release time.
+ */
+export const BUNDLED_PLUGIN_INDEX = [
+    { name: '@stratusagent/plugin-spawn', description: 'Run several tasks at once in short-lived sub-agents' },
+    { name: '@stratusagent/plugin-peer', description: 'Hand a task to an agent on another Stratus daemon' },
+    { name: '@stratusagent/plugin-fleet', description: 'Read-only fleet metadata for an agent that reports what needs a person' },
+    { name: '@stratusagent/plugin-a2ui', description: 'Show a native screen as A2UI, checked against your catalogs' },
+    { name: '@stratusagent/plugin-dreams', description: 'Overnight experiment runs and a morning report (macOS)' },
+];
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Line breaks and control characters (C0, DEL, C1, and the Unicode line and
+ * paragraph separators). Index text and registry versions are printed
+ * straight into setup's menu: a line break breaks the row, and an escape
+ * sequence is something the terminal would act on.
+ */
+const UNPRINTABLE = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
+/** A version as npm publishes one: semver's characters and nothing else. */
+const PLAIN_VERSION = /^[0-9A-Za-z.+-]+$/;
+/**
+ * The entries of an index this CLI can read, or `undefined` for anything
+ * else. An entry without a package name npm could be handed is dropped,
+ * since the names reach `npm view` and `npm install -g`, and on Windows
+ * those run through a shell. So is one whose description is empty or has a
+ * line break or control character.
+ */
+export const parsePluginIndex = (value) => {
+    if (!isObject(value) || value.schemaVersion !== PLUGIN_INDEX_SCHEMA_VERSION || !Array.isArray(value.plugins)) {
+        return undefined;
+    }
+    const entries = [];
+    const seen = new Set();
+    for (const entry of value.plugins) {
+        if (!isObject(entry) || typeof entry.name !== 'string' || typeof entry.description !== 'string') {
+            continue;
+        }
+        const description = entry.description.trim();
+        if (!isPackageName(entry.name) || description.length === 0 || UNPRINTABLE.test(description) || seen.has(entry.name)) {
+            continue;
+        }
+        seen.add(entry.name);
+        entries.push({ name: entry.name, description });
+    }
+    return entries;
+};
+export const defaultPluginIndexReader = async () => {
+    const result = await runNpm(['view', `${PLUGIN_INDEX_PACKAGE}@latest`, PLUGIN_INDEX_FIELD, '--json']);
+    if (result === undefined || result.code !== 0 || result.stdout.trim().length === 0) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(result.stdout);
+    }
+    catch {
+        return undefined;
+    }
+};
+/** The index to show, and whether it came from npm or this CLI's own copy. */
+export const readPluginIndex = async (env) => {
+    const published = await (env.pluginIndexReader ?? defaultPluginIndexReader)().catch(() => undefined);
+    const entries = parsePluginIndex(published);
+    return entries === undefined
+        ? { source: 'bundled', entries: [...BUNDLED_PLUGIN_INDEX] }
+        : { source: 'npm', entries };
+};
+/**
+ * Reads `npm view <name>@latest version stratus os cpu libc --json`.
+ *
+ * npm prints an object when more than one requested field exists and the
+ * bare value when only one does. `version` always exists, so a bare string
+ * is a release with neither a manifest nor an os field.
+ */
+export const parseNpmView = (result) => {
+    if (result === undefined) {
+        return { status: 'unknown' };
+    }
+    let printed;
+    try {
+        printed = result.stdout.trim().length > 0 ? JSON.parse(result.stdout) : undefined;
+    }
+    catch {
+        printed = undefined;
+    }
+    if (result.code !== 0) {
+        const code = isObject(printed) && isObject(printed.error) ? printed.error.code : undefined;
+        return code === 'E404' || /\bE404\b/.test(result.stderr) ? { status: 'unpublished' } : { status: 'unknown' };
+    }
+    // The version is printed in setup's reason lines, and the registry is
+    // whichever one the operator's npm points at.
+    if (typeof printed === 'string') {
+        return PLAIN_VERSION.test(printed) ? { status: 'published', version: printed } : { status: 'unknown' };
+    }
+    if (!isObject(printed) || typeof printed.version !== 'string' || !PLAIN_VERSION.test(printed.version)) {
+        return { status: 'unknown' };
+    }
+    return {
+        status: 'published',
+        version: printed.version,
+        ...('stratus' in printed ? { stratus: printed.stratus } : {}),
+        ...('os' in printed ? { os: printed.os } : {}),
+        ...('cpu' in printed ? { cpu: printed.cpu } : {}),
+        ...('libc' in printed ? { libc: printed.libc } : {}),
+    };
+};
+export const defaultPluginReleaseReader = async (name) => {
+    if (!isPackageName(name)) {
+        return { status: 'unknown' };
+    }
+    return parseNpmView(await runNpm(['view', `${name}@latest`, 'version', 'stratus', 'os', 'cpu', 'libc', '--json']));
+};
+/** How many `npm view` processes run at once. Each is a Node process. */
+const RELEASE_CHECK_CONCURRENCY = 4;
+/** Asks npm about each name once, a few at a time. A reader that throws is an unknown answer. */
+export const checkPluginReleases = async (names, env) => {
+    const read = env.pluginReleaseReader ?? defaultPluginReleaseReader;
+    const queue = [...new Set(names)];
+    const releases = new Map();
+    const worker = async () => {
+        for (let name = queue.shift(); name !== undefined; name = queue.shift()) {
+            releases.set(name, await read(name).catch(() => ({ status: 'unknown' })));
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(RELEASE_CHECK_CONCURRENCY, queue.length) }, worker));
+    return releases;
+};
+let libcFamily;
+/**
+ * This machine, read the way npm reads it before an install: libc only on
+ * Linux, from `/usr/bin/ldd` and then the process report.
+ */
+export const currentPlatformHost = () => {
+    if (process.platform === 'linux' && libcFamily === undefined) {
+        try {
+            const ldd = readFileSync('/usr/bin/ldd', 'utf8');
+            libcFamily = ldd.includes('musl') ? 'musl' : ldd.includes('GNU C Library') ? 'glibc' : null;
+        }
+        catch {
+            const report = process.report?.getReport();
+            libcFamily = report?.header?.glibcVersionRuntime
+                ? 'glibc'
+                : report?.sharedObjects?.some((file) => file.includes('libc.musl-') || file.includes('ld-musl-')) ? 'musl' : null;
+        }
+    }
+    return { os: process.platform, cpu: process.arch, libc: process.platform === 'linux' ? libcFamily ?? null : null };
+};
+/**
+ * npm's own reading of an `os`, `cpu` or `libc` field (npm-install-checks
+ * `checkList`): a `!name` entry excludes that value, any plain entry makes
+ * the list an allowlist, and `any` alone allows everything. A field that is
+ * neither a string nor a list of strings is one npm would not enforce
+ * either.
+ */
+const listAllows = (field, value) => {
+    const list = typeof field === 'string' ? [field] : Array.isArray(field) && field.every((entry) => typeof entry === 'string') ? field : undefined;
+    if (list === undefined || list.length === 0 || (list.length === 1 && list[0] === 'any')) {
+        return true;
+    }
+    let negated = 0;
+    let match = false;
+    for (const entry of list) {
+        if (entry.startsWith('!')) {
+            negated += 1;
+            if (entry.slice(1) === value) {
+                return false;
+            }
+        }
+        else if (entry === value) {
+            match = true;
+        }
+    }
+    return match || negated === list.length;
+};
+/**
+ * Whether a release would install and load here, read from the release
+ * itself rather than the index. Each check defers to the code that would
+ * refuse it later: the loader's own manifest parser, npm's platform checks,
+ * and the installer's fence on what reaches npm. Only the latest release is
+ * asked about, and whoever installs it pins exactly that version. One that
+ * fails is never installed, so a publisher's incompatible release can't
+ * break an older CLI.
+ *
+ * `stratus update` uses this as it is. Setup's More plugins adds one more
+ * condition on top (`releaseVerdict`).
+ */
+export const loadableRelease = (name, release, host) => {
+    if (release.status === 'unpublished') {
+        return { ok: false, reason: 'not on npm yet' };
+    }
+    if (release.status === 'unknown') {
+        return { ok: false, reason: 'npm did not answer' };
+    }
+    const { version, stratus } = release;
+    if (!isObject(stratus)) {
+        return { ok: false, reason: `its latest release (${version}) is not a Stratus plugin` };
+    }
+    if (stratus.pluginVersion !== PLUGIN_MANIFEST_VERSION) {
+        return {
+            ok: false,
+            reason: `its latest release (${version}) is plugin version ${JSON.stringify(stratus.pluginVersion)}, and this CLI loads version ${PLUGIN_MANIFEST_VERSION}`,
+        };
+    }
+    let contributes;
+    try {
+        ({ contributes } = parsePluginManifest({ name, stratus }, name));
+    }
+    catch (error) {
+        // The loader quotes what it refuses with JSON.stringify, and anything
+        // that still is not printable goes, since this is printed to a terminal.
+        const message = (error instanceof Error ? error.message : String(error)).replace(new RegExp(UNPRINTABLE.source, 'g'), '');
+        return { ok: false, reason: `its latest release (${version}) has a manifest this CLI would refuse: ${message}` };
+    }
+    // The checks npm makes before it installs (checkPlatform), so npm does
+    // not refuse with EBADPLATFORM what was just judged installable.
+    if (!listAllows(release.os, host.os)) {
+        return { ok: false, reason: `it does not run on ${host.os}` };
+    }
+    if (!listAllows(release.cpu, host.cpu)) {
+        return { ok: false, reason: `it does not run on ${host.cpu}` };
+    }
+    if (release.libc !== undefined && release.libc !== null && host.libc === null) {
+        return { ok: false, reason: 'it needs a libc this host does not report' };
+    }
+    if (host.libc !== null && !listAllows(release.libc, host.libc)) {
+        return { ok: false, reason: `it does not run with ${host.libc}` };
+    }
+    // Last, the installer's own fence on what reaches npm (a shell on
+    // Windows): a release the installer then refuses is a dead end.
+    if (!isInstallableSpecifier(installSpecifier(name, version))) {
+        return {
+            ok: false,
+            reason: `this CLI can't pass its latest release (${version}) to npm; run npm install -g ${installSpecifier(name, version)} yourself`,
+        };
+    }
+    return { ok: true, version, contributes };
+};
+/**
+ * Whether setup's More plugins offers a release: it has to be loadable
+ * (`loadableRelease`), and it has to add tools, since setup's Plugins menu
+ * is a tools menu.
+ *
+ * A package that is already installed but not configured goes to the
+ * normal enable path, which checks the installed copy's manifest with the
+ * loader's preflight before writing anything. Setup doesn't replace a copy
+ * the operator installed; keeping it current is `stratus update`'s job.
+ */
+export const releaseVerdict = (name, release, host) => {
+    const loadable = loadableRelease(name, release, host);
+    if (!loadable.ok) {
+        return { offer: false, reason: loadable.reason };
+    }
+    const { contributes } = loadable;
+    if (contributes.tools.length === 0 && contributes.toolsDiscovered.length === 0) {
+        return { offer: false, reason: 'it adds no tools' };
+    }
+    return { offer: true, version: loadable.version };
+};
+/**
+ * What setup hands `npm install -g` for a release it checked: that exact
+ * version. A bare name installs whatever npm's configured `tag` points at,
+ * which need not be the `latest` release the checks above passed. The
+ * `plugins` key stays the bare name, since that is what the loader imports.
+ */
+export const installSpecifier = (name, version) => `${name}@${version}`;
+//# sourceMappingURL=plugin-index.js.map

package/dist/plugin-index.js.map

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

package/dist/plugin-updates.d.ts

@@ -0,0 +1,54 @@
+import type { CliEnvironment } from './environment.ts';
+/** One configured plugin that releases apart from the CLI, and what `stratus update` can do about it. */
+export type PluginUpdate = {
+    name: string;
+    installed: string;
+    state: 'current';
+}
+/** Its latest release is newer and would load here: install exactly `version`. */
+ | {
+    name: string;
+    installed: string;
+    state: 'behind';
+    version: string;
+}
+/** Its latest release is newer, and this CLI would refuse it. */
+ | {
+    name: string;
+    installed: string;
+    state: 'held';
+    version: string;
+    reason: string;
+}
+/** npm gave no answer about it. */
+ | {
+    name: string;
+    installed: string;
+    state: 'unchecked';
+    reason: string;
+};
+/**
+ * The plugins this machine runs that release on their own (everything from
+ * `stratuslabs/plugins`, and anyone else's), and whether each lags its
+ * latest release.
+ *
+ * The inventory is the trusted config's `plugins` block, read the way the
+ * daemon reads it, narrowed to packages that are installed here: that is
+ * what the daemon loads. Not the curated index, so a plugin installed by
+ * hand, or later dropped from the index, is still kept current, and a
+ * package that moves out of the monorepo keeps upgrading where it is
+ * configured. A plugin installed but never configured is not loaded, and
+ * setup's enable path checks its installed copy before using it.
+ *
+ * A newer release counts only if this build would load it, judged as
+ * setup's More plugins judges one (`loadableRelease`), so an update never
+ * moves a plugin to a release the loader would then refuse. Only the
+ * latest release is asked about; one that fails is reported as held and
+ * the installed copy stays.
+ *
+ * A config that can't be read gives no inventory rather than an error:
+ * the daemon would load no plugins from it either, and `doctor` is the
+ * command that reports why.
+ */
+export declare const readPluginUpdates: (env: CliEnvironment, configPath: string | undefined) => Promise<PluginUpdate[]>;
+//# sourceMappingURL=plugin-updates.d.ts.map

package/dist/plugin-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-updates.d.ts","sourceRoot":"","sources":["../src/plugin-updates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASvD,yGAAyG;AACzG,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AACvD,kFAAkF;GAChF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACvE,iEAAiE;GAC/D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrF,mCAAmC;GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAY5E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,cAAc,EACnB,YAAY,MAAM,GAAG,SAAS,KAC7B,OAAO,CAAC,YAAY,EAAE,CA6BxB,CAAC"}

package/dist/plugin-updates.js

@@ -0,0 +1,68 @@
+import { isPackageName } from '@stratusagent/plugins';
+import { CLI_PACKAGE_NAME, compareVersions, defaultInstalledVersionReader } from "./npm.js";
+import { FIRST_PARTY_CAPABILITY_PACKAGES, FIRST_PARTY_COMPANION_PACKAGES, } from "./plugin-catalog.js";
+import { checkPluginReleases, currentPlatformHost, loadableRelease } from "./plugin-index.js";
+import { loadServePlugins } from "./trusted-config.js";
+/**
+ * The packages released with the CLI. `readCompanions` holds them to the
+ * CLI's own version, so they are never part of this sweep.
+ */
+const RELEASED_WITH_THE_CLI = new Set([
+    CLI_PACKAGE_NAME,
+    ...FIRST_PARTY_COMPANION_PACKAGES,
+    ...FIRST_PARTY_CAPABILITY_PACKAGES,
+]);
+/**
+ * The plugins this machine runs that release on their own (everything from
+ * `stratuslabs/plugins`, and anyone else's), and whether each lags its
+ * latest release.
+ *
+ * The inventory is the trusted config's `plugins` block, read the way the
+ * daemon reads it, narrowed to packages that are installed here: that is
+ * what the daemon loads. Not the curated index, so a plugin installed by
+ * hand, or later dropped from the index, is still kept current, and a
+ * package that moves out of the monorepo keeps upgrading where it is
+ * configured. A plugin installed but never configured is not loaded, and
+ * setup's enable path checks its installed copy before using it.
+ *
+ * A newer release counts only if this build would load it, judged as
+ * setup's More plugins judges one (`loadableRelease`), so an update never
+ * moves a plugin to a release the loader would then refuse. Only the
+ * latest release is asked about; one that fails is reported as held and
+ * the installed copy stays.
+ *
+ * A config that can't be read gives no inventory rather than an error:
+ * the daemon would load no plugins from it either, and `doctor` is the
+ * command that reports why.
+ */
+export const readPluginUpdates = async (env, configPath) => {
+    const configured = Object.keys(await loadServePlugins(env, configPath, () => { }).catch(() => ({})))
+        .filter((name) => isPackageName(name) && !RELEASED_WITH_THE_CLI.has(name));
+    const read = env.installedVersionReader ?? defaultInstalledVersionReader;
+    const installed = [];
+    for (const name of configured) {
+        const version = await read(name).catch(() => undefined);
+        if (version !== undefined) {
+            installed.push({ name, version });
+        }
+    }
+    if (installed.length === 0) {
+        return [];
+    }
+    const releases = await checkPluginReleases(installed.map((entry) => entry.name), env);
+    const host = currentPlatformHost();
+    return installed.map(({ name, version }) => {
+        const release = releases.get(name) ?? { status: 'unknown' };
+        if (release.status !== 'published') {
+            return { name, installed: version, state: 'unchecked', reason: release.status === 'unknown' ? 'npm did not answer' : 'not on npm' };
+        }
+        if (compareVersions(release.version, version) <= 0) {
+            return { name, installed: version, state: 'current' };
+        }
+        const loadable = loadableRelease(name, release, host);
+        return loadable.ok
+            ? { name, installed: version, state: 'behind', version: loadable.version }
+            : { name, installed: version, state: 'held', version: release.version, reason: loadable.reason };
+    });
+};
+//# sourceMappingURL=plugin-updates.js.map

package/dist/plugin-updates.js.map

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

package/dist/provider-packages.d.ts

@@ -0,0 +1,34 @@
+import type { CliEnvironment, CliStreams } from './environment.ts';
+/**
+ * The provider packages (anthropic, claude-code, codex) that the agents
+ * this config serves run on and that are not installed here.
+ *
+ * None ships with the CLI: the harnesses each bring a native binary of a
+ * few hundred MB, and a fresh install carries no provider at all, so most
+ * machines have only the one they picked. Whatever decides a provider
+ * (setup) or replaces the CLI (update) has to put the one in use beside it.
+ * Read through `servedRuntimes`, the same resolution the daemon and doctor
+ * use, so a soul that pins its own provider counts; a runtime that does not
+ * resolve is left to the checks that report that.
+ */
+export declare const missingProviderPackages: (env: CliEnvironment, configPath?: string, 
+/** Setup and update, which install what a service started later runs on. */
+options?: {
+    asService?: boolean;
+}) => Promise<string[]>;
+/**
+ * Installs `packages` at this CLI's own version (they ship in lockstep) and
+ * says so. Returns whether npm succeeded. Never throws: the caller has
+ * already saved what it saved, and a missing provider fails only the turns
+ * that need it, with the install command.
+ */
+export declare const installProviderPackages: (packages: readonly string[], streams: CliStreams, env: CliEnvironment) => Promise<boolean>;
+/**
+ * What doctor and serve say when an agent's provider package is not
+ * installed: a plain `npm install -g @stratusagent/cli` upgrade from a build
+ * that carried it drops it (the Anthropic adapter and, earlier, the
+ * harnesses were CLI dependencies), and every turn on that provider then
+ * fails.
+ */
+export declare const providerPackagesMissingMessage: (packages: readonly string[]) => string;
+//# sourceMappingURL=provider-packages.d.ts.map

package/dist/provider-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-packages.d.ts","sourceRoot":"","sources":["../src/provider-packages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,cAAc,EACnB,aAAa,MAAM;AACnB,4EAA4E;AAC5E,UAAS;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,KACpC,OAAO,CAAC,MAAM,EAAE,CAuBlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,SAAS,MAAM,EAAE,EAC3B,SAAS,UAAU,EACnB,KAAK,cAAc,KAClB,OAAO,CAAC,OAAO,CAgBjB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,GAAI,UAAU,SAAS,MAAM,EAAE,KAAG,MAI5E,CAAC"}

package/dist/{harness-packages.js → provider-packages.js}

@@ -1,19 +1,20 @@
-import { HARNESS_PACKAGE_NAMES, harnessesUsedBy, readProcessEnv, servedRuntimes } from '@stratusagent/state';
+import { PROVIDER_PACKAGE_NAMES, providerPackagesUsedBy, readProcessEnv, servedRuntimes } from '@stratusagent/state';
 import { writeLine } from "./io.js";
 import { packageInstalled } from "./loaders.js";
 import { CLI_VERSION, defaultPackageInstaller } from "./npm.js";
 /**
- * The harness provider packages (claude-code, codex) that the agents this
- * config serves run on and that are not installed here.
+ * The provider packages (anthropic, claude-code, codex) that the agents
+ * this config serves run on and that are not installed here.
  *
- * Neither ships with the CLI: each brings a native binary of a few hundred
- * MB, and most machines use one or neither. So whatever decides a provider
+ * None ships with the CLI: the harnesses each bring a native binary of a
+ * few hundred MB, and a fresh install carries no provider at all, so most
+ * machines have only the one they picked. Whatever decides a provider
  * (setup) or replaces the CLI (update) has to put the one in use beside it.
  * Read through `servedRuntimes`, the same resolution the daemon and doctor
  * use, so a soul that pins its own provider counts; a runtime that does not
  * resolve is left to the checks that report that.
  */
-export const missingHarnessPackages = async (env, configPath, 
+export const missingProviderPackages = async (env, configPath, 
 /** Setup and update, which install what a service started later runs on. */
 options = {}) => {
     // With asService, resolved twice: as this shell would run it, and as the
@@ -21,7 +22,7 @@ options = {}) => {
     // The unit carries only PATH, so a provider key or STRATUS_* override
     // exported here (ANTHROPIC_API_KEY beside a stored Claude sign-in, say)
     // reaches a foreground run but never the daemon, which then needs the
-    // harness this shell's view would skip. Installing one a shell override
+    // package this shell's view would skip. Installing one a shell override
     // happens to avoid costs disk; missing one fails every turn.
     const shellEnv = readProcessEnv(env);
     const serviceEnv = {
@@ -32,18 +33,18 @@ options = {}) => {
         },
     };
     const runtimes = (await Promise.all((options.asService ? [env, serviceEnv] : [env]).map((view) => servedRuntimes(view, configPath).catch(() => [])))).flat();
-    const used = new Set(runtimes.flatMap(({ runtime }) => harnessesUsedBy(runtime)));
+    const used = new Set(runtimes.flatMap(({ runtime }) => providerPackagesUsedBy(runtime)));
     return [...used]
-        .map((harness) => HARNESS_PACKAGE_NAMES[harness])
+        .map((pkg) => PROVIDER_PACKAGE_NAMES[pkg])
         .filter((name) => !packageInstalled(name, env));
 };
 /**
  * Installs `packages` at this CLI's own version (they ship in lockstep) and
  * says so. Returns whether npm succeeded. Never throws: the caller has
- * already saved what it saved, and a missing harness fails only the turns
+ * already saved what it saved, and a missing provider fails only the turns
  * that need it, with the install command.
  */
-export const installHarnessPackages = async (packages, streams, env) => {
+export const installProviderPackages = async (packages, streams, env) => {
     if (packages.length === 0) {
         return true;
     }
@@ -61,13 +62,15 @@ export const installHarnessPackages = async (packages, streams, env) => {
     return false;
 };
 /**
- * What doctor and serve say when an agent's harness is not installed: a
- * plain `npm install -g @stratusagent/cli` upgrade from a build that carried
- * both drops them, and every turn on that provider then fails.
+ * What doctor and serve say when an agent's provider package is not
+ * installed: a plain `npm install -g @stratusagent/cli` upgrade from a build
+ * that carried it drops it (the Anthropic adapter and, earlier, the
+ * harnesses were CLI dependencies), and every turn on that provider then
+ * fails.
  */
-export const harnessesMissingMessage = (packages) => {
+export const providerPackagesMissingMessage = (packages) => {
     const one = packages.length === 1;
     return `${packages.join(' and ')} ${one ? 'is' : 'are'} not installed, and ${one ? 'an agent runs on it' : 'agents run on them'}, so ${one ? 'its' : 'their'} turns fail. `
         + `Run \`stratus update\` or \`npm install -g ${packages.map((name) => `${name}@${CLI_VERSION}`).join(' ')}\`, then restart the daemon.`;
 };
-//# sourceMappingURL=harness-packages.js.map
+//# sourceMappingURL=provider-packages.js.map

package/dist/provider-packages.js.map

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

package/dist/roster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,SAAS,MAAM,EAAE,GAAG,SAAS,EACpC,MAAM,MAAM,EACZ,YAAY,OAAO,KAClB,OAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,KAAK,cAAc,EACnB,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC5B,UAAS;IACP;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACrB,KACL,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAgCrF,CAAC"}
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AACnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,SAAS,MAAM,EAAE,GAAG,SAAS,EACpC,MAAM,MAAM,EACZ,YAAY,OAAO,KAClB,OAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,KAAK,cAAc,EACnB,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC5B,UAAS;IACP;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACrB,KACL,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAkDrF,CAAC"}

package/dist/roster.js

@@ -1,5 +1,5 @@
 import { matchesToolAllowlist, toolScopesOverlap } from '@stratusagent/core';
-import { DEFAULT_STRATUS_AGENT, loadRosterSouls, resolveConfiguredSoul } from '@stratusagent/state';
+import { DEFAULT_STRATUS_AGENT, foldedAgentId, loadRosterSouls, resolveConfiguredSoul } from '@stratusagent/state';
 /**
  * npm's package-name grammar, and nothing else: an optional `@scope/`, then
  * lowercase alphanumerics with `-`, `_` and `.`, no leading `.` or `_`, 214
@@ -53,7 +53,24 @@ export const rosterSoulsWithConfigured = async (env, warn, options = {}) => {
     let complete = true;
     try {
         const configured = await resolveConfiguredSoul(configPath !== undefined ? { configPath } : {}, env);
-        if (configured) {
+        // The gateway's rule for a default soul that never went through the
+        // roster's fold check (stateDirectoryPeer in defaultAgentId): an id
+        // that names another agent's state directory without being that id,
+        // `Stratus` beside the built-in or `Ava` beside roster `ava`, is
+        // dropped and default dispatches go to the built-in. The built-in is
+        // always registered there, so it is folded against here whether or not
+        // the caller lists it.
+        const id = configured?.soul.agent.id;
+        const peer = id === undefined
+            ? undefined
+            : [DEFAULT_STRATUS_AGENT.id, ...entries.map((candidate) => candidate.soul.agent.id)]
+                .find((other) => other !== id && foldedAgentId(other) === foldedAgentId(id));
+        if (configured && peer !== undefined) {
+            warn(`the configured default soul at ${configured.path} declares the agent id ${id}, which names the same `
+                + `state directory as ${peer}, so the daemon ignores it and routes to ${DEFAULT_STRATUS_AGENT.id}. `
+                + 'Rename one of the two ids.');
+        }
+        else if (configured) {
             const entry = { soul: configured.soul, path: configured.path };
             const clash = entries.findIndex((candidate) => candidate.soul.agent.id === configured.soul.agent.id);
             // Replaced, not skipped: a roster file claiming the configured

package/dist/roster.js.map

@@ -1 +1 @@
-{"version":3,"file":"roster.js","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGpG;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAoC,EACpC,IAAY,EACZ,UAAmB,EACV,EAAE;IACX,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,UAAU;QACf,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAC5C,GAAmB,EACnB,IAA4B,EAC5B,UAiBI,EAAE,EACgF,EAAE;IACxF,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACvD,wEAAwE;IACxE,yEAAyE;IACzE,qEAAqE;IACrE,wDAAwD;IACxD,MAAM,OAAO,GAAG,cAAc;QAC5B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,qBAAqB,EAAE,EAAE,EAAyD;YACzG,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACpG,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrG,+DAA+D;YAC/D,iEAAiE;YACjE,qDAAqD;YACrD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mEAAmE;QACnE,oEAAoE;QACpE,QAAQ,GAAG,KAAK,CAAC;QACjB,IAAI,CAAC,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC"}
+{"version":3,"file":"roster.js","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"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"}