@meetquinn/animactl 0.1.2 → 0.1.3

package/README.md

@@ -3,11 +3,16 @@
 Operator CLI for installing and running Anima from npm.
 
 ```bash
-npx @meetquinn/animactl start
-npx @meetquinn/animactl@canary restart
-npx @meetquinn/animactl status
-npx @meetquinn/animactl stop
+npx -y @meetquinn/animactl start
+npx -y @meetquinn/animactl dashboard
+npx -y @meetquinn/animactl restart
+npx -y @meetquinn/animactl@canary restart
+npx -y @meetquinn/animactl status
+npx -y @meetquinn/animactl stop
 ```
 
-This package installs the `@meetquinn/animactl` runtime into `~/.anima/runtime/current` and runs
-services from that pinned runtime. Durable Anima data remains in `~/.anima`.
+This package installs the selected `@meetquinn/animactl` runtime into
+`~/.anima/runtime/current` and runs services from that pinned runtime. Durable Anima data remains
+in `~/.anima`. `start` launches the dashboard automatically on a local desktop; use `dashboard` to
+launch it again. Use `restart` for command-line upgrades; with no version suffix, `npx` selects the
+`latest` npm dist-tag.

package/dist/server/{runtime/activity-payload.d.ts → activities/format.d.ts}

@@ -1,5 +1,8 @@
+export declare function truncateForActivity(text: string): string;
+export declare function runtimeErrorPayload(error: unknown): Record<string, unknown>;
 export declare function copyNumber(source: Record<string, unknown> | undefined, target: Record<string, unknown>, from: string, to: string): void;
 export declare function copyString(source: Record<string, unknown> | undefined, target: Record<string, unknown>, from: string, to: string): void;
 export declare function copyBoolean(source: Record<string, unknown> | undefined, target: Record<string, unknown>, from: string, to: string): void;
 export declare function copyActivityPreview(source: Record<string, unknown> | undefined, target: Record<string, unknown>, from: string, to: string): void;
-//# sourceMappingURL=activity-payload.d.ts.map
+export declare function isFirstClassAnimaCliCommand(command: string | undefined): boolean;
+//# sourceMappingURL=format.d.ts.map

package/dist/server/activities/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../server/activities/format.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3E;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAGN;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAGN;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAGN;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAGN;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAOhF"}

package/dist/server/{runtime/activity-payload.js → activities/format.js}

@@ -1,4 +1,12 @@
-import { truncateForActivity } from './activity-text.js';
+import { errorMessage } from '../ids.js';
+export function truncateForActivity(text) {
+    return text.trim().slice(0, 4000);
+}
+export function runtimeErrorPayload(error) {
+    return {
+        error: truncateForActivity(errorMessage(error)),
+    };
+}
 export function copyNumber(source, target, from, to) {
     const value = source?.[from];
     if (typeof value === 'number' && Number.isFinite(value))
@@ -19,3 +27,10 @@ export function copyActivityPreview(source, target, from, to) {
     if (typeof value === 'string' && value)
         target[to] = truncateForActivity(value);
 }
+export function isFirstClassAnimaCliCommand(command) {
+    const trimmed = command?.trim();
+    if (!trimmed)
+        return false;
+    const withOptionalEnv = String.raw `(?:[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S+)\s+)*`;
+    return new RegExp(String.raw `^${withOptionalEnv}anima\s+(?:ask|message\s+(?:read|send|update|react)|file\s+send|reminder\s+(?:schedule|cancel|snooze|list)|subscription\s+(?:list|mute))\b`).test(trimmed);
+}

package/dist/server/agents/agent-skills.d.ts

@@ -1,4 +1,8 @@
-import type { AgentConfig } from '../../shared/agent-config.js';
-import type { AgentSkills } from '../../shared/skills.js';
-export declare function scanAgentSkills(agent: AgentConfig): Promise<AgentSkills>;
+import type { AgentConfig } from "../../shared/agent-config.js";
+import type { AgentSkills } from "../../shared/skills.js";
+interface SkillScanOptions {
+    homeDir?: string;
+}
+export declare function scanAgentSkills(agent: AgentConfig, options?: SkillScanOptions): Promise<AgentSkills>;
+export {};
 //# sourceMappingURL=agent-skills.d.ts.map

package/dist/server/agents/agent-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-skills.d.ts","sourceRoot":"","sources":["../../../server/agents/agent-skills.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,wBAAwB,CAAC;AAMxE,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAS9E"}
+{"version":3,"file":"agent-skills.d.ts","sourceRoot":"","sources":["../../../server/agents/agent-skills.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,wBAAwB,CAAC;AAKhC,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD,wBAAsB,eAAe,CACnC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/server/agents/agent-skills.js

@@ -1,56 +1,253 @@
-import { readdir, readFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { resolveAgentHomePath } from './agent-config-ops.js';
-const GLOBAL_AGENTS_SKILLS = join(homedir(), '.agents', 'skills');
-const GLOBAL_CODEX_SKILLS = join(homedir(), '.codex', 'skills');
-export async function scanAgentSkills(agent) {
-    const isCodex = agent.provider.kind === 'codex-cli';
-    const globalPath = isCodex ? GLOBAL_CODEX_SKILLS : GLOBAL_AGENTS_SKILLS;
-    const localPath = join(resolveAgentHomePath(agent), '.claude', 'skills');
-    const [global, local] = await Promise.all([
-        scanSkillDir(globalPath, isCodex),
-        scanSkillDir(localPath, false),
-    ]);
-    return { global, globalPath, local, localPath };
-}
-async function scanSkillDir(dir, excludeSystem) {
-    let dirNames;
+import { lstat, readdir, readFile, realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { resolveAgentHomePath } from "./agent-config-ops.js";
+const PLUGIN_CACHE_MAX_DEPTH = 8;
+export async function scanAgentSkills(agent, options = {}) {
+    const roots = skillRoots(options.homeDir ?? homedir());
+    const agentHome = resolveAgentHomePath(agent);
+    const globalDefinitions = await globalSkillSources(agent, roots);
+    const localDefinitions = localSkillSources(agent, agentHome);
+    const globalSources = await scanSources(globalDefinitions);
+    const localSources = await scanSources(localDefinitions);
+    return {
+        global: flattenSources(globalSources),
+        globalPath: pathSummary(globalSources, globalDefinitions),
+        globalSources,
+        local: flattenSources(localSources),
+        localPath: pathSummary(localSources, localDefinitions),
+        localSources,
+    };
+}
+function skillRoots(homeDir) {
+    return {
+        agentsSkills: join(homeDir, ".agents", "skills"),
+        claudeInstalledPlugins: join(homeDir, ".claude", "plugins", "installed_plugins.json"),
+        claudePluginsCache: join(homeDir, ".claude", "plugins", "cache"),
+        claudeSkills: join(homeDir, ".claude", "skills"),
+        codexPluginsCache: join(homeDir, ".codex", "plugins", "cache"),
+        codexSkills: join(homeDir, ".codex", "skills"),
+        codexSystemSkills: join(homeDir, ".codex", "skills", ".system"),
+    };
+}
+async function globalSkillSources(agent, roots) {
+    if (agent.provider.kind === "codex-cli") {
+        return [
+            { kind: "common", label: "Common", path: roots.agentsSkills },
+            { kind: "provider", label: "Codex", path: roots.codexSkills },
+            { kind: "system", label: "Built-in", path: roots.codexSystemSkills },
+            {
+                kind: "bundled",
+                label: "Bundled",
+                path: roots.codexPluginsCache,
+                scanner: "nested",
+            },
+        ];
+    }
+    if (agent.provider.kind === "claude-code") {
+        return [
+            { kind: "common", label: "Common", path: roots.agentsSkills },
+            { kind: "provider", label: "Claude Code", path: roots.claudeSkills },
+            ...(await claudeUserPluginSources(roots)),
+        ];
+    }
+    return [{ kind: "common", label: "Common", path: roots.agentsSkills }];
+}
+function localSkillSources(agent, agentHome) {
+    const common = {
+        kind: "local",
+        label: "Agent",
+        path: join(agentHome, ".agents", "skills"),
+    };
+    if (agent.provider.kind === "codex-cli") {
+        return [
+            common,
+            {
+                kind: "local",
+                label: "Agent Codex",
+                path: join(agentHome, ".codex", "skills"),
+            },
+        ];
+    }
+    if (agent.provider.kind === "claude-code") {
+        return [
+            common,
+            {
+                kind: "local",
+                label: "Agent Claude Code",
+                path: join(agentHome, ".claude", "skills"),
+            },
+        ];
+    }
+    return [common];
+}
+async function claudeUserPluginSources(roots) {
+    const installed = await readJsonFile(roots.claudeInstalledPlugins);
+    if (!isRecord(installed) || !isRecord(installed["plugins"]))
+        return [];
+    const sources = [];
+    for (const [pluginId, installs] of Object.entries(installed["plugins"])) {
+        if (!Array.isArray(installs))
+            continue;
+        for (const install of installs) {
+            if (!isRecord(install))
+                continue;
+            if (install["scope"] !== "user")
+                continue;
+            const installPath = stringValue(install["installPath"]);
+            if (!installPath)
+                continue;
+            sources.push({
+                kind: "provider",
+                label: pluginLabel(pluginId, "Claude plugin"),
+                path: installPath,
+                scanner: "nested",
+            });
+        }
+    }
+    return sources;
+}
+function pluginLabel(pluginId, fallback) {
+    const [name] = pluginId.split("@");
+    return name ? name : fallback;
+}
+async function scanSources(definitions) {
+    const seenRealPaths = new Set();
+    const sources = [];
+    for (const definition of definitions) {
+        const results = definition.scanner === "nested"
+            ? await scanNestedSkillDirs(definition, seenRealPaths)
+            : await scanTopLevelSkillDir(definition, seenRealPaths);
+        sources.push({
+            kind: definition.kind,
+            label: definition.label,
+            path: definition.path,
+            skills: results.map(stripInternalFields),
+        });
+    }
+    return sources;
+}
+async function scanTopLevelSkillDir(definition, seenRealPaths) {
+    let entries;
     try {
-        const entries = await readdir(dir, { withFileTypes: true });
-        dirNames = entries
-            .filter((entry) => {
-            if (!entry.isDirectory())
-                return false;
-            if (excludeSystem && entry.name === '.system')
-                return false;
-            if (entry.name.startsWith('.'))
-                return false;
-            return true;
-        })
-            .map((entry) => entry.name)
-            .sort();
+        entries = await readdir(definition.path, { withFileTypes: true });
     }
     catch {
         return [];
     }
-    const results = await Promise.all(dirNames.map((dirName) => readSkill(dir, dirName)));
+    const dirNames = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        if (entry.isDirectory()) {
+            dirNames.push(entry.name);
+            continue;
+        }
+        if (!entry.isSymbolicLink())
+            continue;
+        try {
+            const linkTarget = await lstat(join(definition.path, entry.name));
+            if (linkTarget.isSymbolicLink())
+                dirNames.push(entry.name);
+        }
+        catch {
+            // Ignore broken links.
+        }
+    }
+    const results = await Promise.all(dirNames
+        .sort()
+        .map((dirName) => readSkill(join(definition.path, dirName), dirName, definition, seenRealPaths)));
     return results.filter((skill) => skill !== null);
 }
-async function readSkill(base, dirName) {
+async function scanNestedSkillDirs(definition, seenRealPaths) {
+    const dirs = await findSkillDirs(definition.path, definition.scanner === "nested" ? PLUGIN_CACHE_MAX_DEPTH : 3);
+    const results = await Promise.all(dirs.map((dir) => readSkill(dir, basename(dir), definition, seenRealPaths)));
+    return results
+        .filter((skill) => skill !== null)
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+async function findSkillDirs(root, maxDepth) {
+    const results = [];
+    async function walk(dir, depth) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        if (entries.some((entry) => entry.isFile() && entry.name === "SKILL.md")) {
+            results.push(dir);
+            return;
+        }
+        await Promise.all(entries.map(async (entry) => {
+            if (!entry.isDirectory())
+                return;
+            if (entry.name === "node_modules")
+                return;
+            await walk(join(dir, entry.name), depth + 1);
+        }));
+    }
+    await walk(root, 0);
+    return results;
+}
+async function readSkill(skillDir, dirName, source, seenRealPaths) {
     try {
-        const content = await readFile(join(base, dirName, 'SKILL.md'), 'utf8');
+        const [content, resolvedPath] = await Promise.all([
+            readFile(join(skillDir, "SKILL.md"), "utf8"),
+            realpath(skillDir),
+        ]);
+        if (seenRealPaths.has(resolvedPath))
+            return null;
+        seenRealPaths.add(resolvedPath);
         const frontmatter = parseSkillFrontmatter(content);
         return {
             dirName,
             name: frontmatter.name ?? dirName,
-            ...(frontmatter.description ? { description: frontmatter.description } : {}),
+            realPath: resolvedPath,
+            sourceKind: source.kind,
+            sourceLabel: source.label,
+            sourcePath: skillDir,
+            ...(frontmatter.description
+                ? { description: frontmatter.description }
+                : {}),
         };
     }
     catch {
         return null;
     }
 }
+function stripInternalFields(skill) {
+    const { realPath: _realPath, ...summary } = skill;
+    return summary;
+}
+function flattenSources(sources) {
+    return sources.flatMap((source) => source.skills);
+}
+function pathSummary(sources, definitions) {
+    const pathsWithSkills = sources
+        .filter((source) => source.skills.length > 0)
+        .map((source) => source.path);
+    return (pathsWithSkills.length > 0
+        ? pathsWithSkills
+        : definitions.map((definition) => definition.path)).join(", ");
+}
+async function readJsonFile(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? resolve(value) : undefined;
+}
 function parseSkillFrontmatter(content) {
     const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
     if (!match)
@@ -61,11 +258,19 @@ function parseSkillFrontmatter(content) {
         if (!keyValue)
             continue;
         const key = keyValue[1];
-        const value = keyValue[2].trim();
-        if (key === 'description' && value)
+        const value = normalizeFrontmatterValue(keyValue[2].trim());
+        if (key === "description" && value)
             result.description = value;
-        if (key === 'name' && value)
+        if (key === "name" && value)
             result.name = value;
     }
     return result;
 }
+function normalizeFrontmatterValue(value) {
+    if (value.length < 2)
+        return value;
+    const quote = value[0];
+    if ((quote !== '"' && quote !== "'") || value[value.length - 1] !== quote)
+        return value;
+    return value.slice(1, -1);
+}

package/dist/server/agents/agent-slack.service.d.ts

@@ -10,6 +10,21 @@ export declare class AgentSlackService {
     getManifestUpdateInfo(): Promise<AgentSlackManifestUpdateInfo>;
     upgradeManifestVersion(input: AgentSlackManifestUpgradeRequest): Promise<AgentConfig>;
     syncDisplayInfo(): Promise<AgentConfig>;
+    /**
+     * Refresh the bot's Slack display info (avatar, name, workspace icon) at most
+     * once per `ttlMs`, stamping `slack.botProfileSyncedAt`. When the last sync is
+     * still fresh this is a cheap no-op — it reads the local config only and makes
+     * NO Slack API calls. Best-effort: callers run it fire-and-forget off the
+     * message path and swallow errors. Pass an existing `client` to reuse the
+     * inbound request's WebClient instead of building a new one.
+     */
+    syncDisplayInfoIfStale(options: {
+        client?: WebClient;
+        ttlMs: number;
+    }): Promise<{
+        synced: boolean;
+    }>;
+    private persistDisplayInfo;
     getWebClient(): Promise<WebClient>;
     getAgentWebClient(): Promise<{
         agent: AgentConfig;

package/dist/server/agents/agent-slack.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-slack.service.d.ts","sourceRoot":"","sources":["../../../server/agents/agent-slack.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoBlD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAGjD,cAAc,CAClB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IAIhC,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwB9D,qBAAqB,IAAI,OAAO,CAAC,4BAA4B,CAAC;IAgB9D,sBAAsB,CAC1B,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,WAAW,CAAC;IAoCjB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAcvC,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAIlC,iBAAiB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAK7E,OAAO,CAAC,iBAAiB;IAInB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK/C,SAAS,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAK1C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB3D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;YAMxB,2BAA2B;CAqD1C;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAE5E"}
+{"version":3,"file":"agent-slack.service.d.ts","sourceRoot":"","sources":["../../../server/agents/agent-slack.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoBlD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAGjD,cAAc,CAClB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IAIhC,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwB9D,qBAAqB,IAAI,OAAO,CAAC,4BAA4B,CAAC;IAgB9D,sBAAsB,CAC1B,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,WAAW,CAAC;IAoCjB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAI7C;;;;;;;OAOG;IACG,sBAAsB,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;YAS5F,kBAAkB;IAuB1B,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAIlC,iBAAiB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAK7E,OAAO,CAAC,iBAAiB;IAInB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK/C,SAAS,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAK1C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB3D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;YAMxB,2BAA2B;CAqD1C;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAE5E"}

package/dist/server/agents/agent-slack.service.js

@@ -87,15 +87,42 @@ export class AgentSlackService {
         });
     }
     async syncDisplayInfo() {
+        return this.persistDisplayInfo(await getSlackDisplayInfo(await this.getWebClient()));
+    }
+    /**
+     * Refresh the bot's Slack display info (avatar, name, workspace icon) at most
+     * once per `ttlMs`, stamping `slack.botProfileSyncedAt`. When the last sync is
+     * still fresh this is a cheap no-op — it reads the local config only and makes
+     * NO Slack API calls. Best-effort: callers run it fire-and-forget off the
+     * message path and swallow errors. Pass an existing `client` to reuse the
+     * inbound request's WebClient instead of building a new one.
+     */
+    async syncDisplayInfoIfStale(options) {
         const agent = await this.agentService.getConfig();
-        const info = await getSlackDisplayInfo(await this.getWebClient());
-        const appId = info.appId ?? appIdFromAppToken(agent.slack.appToken);
+        if (!agent.slack.botToken)
+            return { synced: false };
+        if (isWithinTtl(agent.slack.botProfileSyncedAt, options.ttlMs))
+            return { synced: false };
+        const client = options.client ?? this.webClientForAgent(agent);
+        await this.persistDisplayInfo(await getSlackDisplayInfo(client), nowIso());
+        return { synced: true };
+    }
+    async persistDisplayInfo(info, botProfileSyncedAt) {
+        // Re-read the latest config AFTER the (slow) Slack API calls, then merge in
+        // only the display fields. The automatic on-message refresh runs fire-and-
+        // forget, so an operator could edit config in the dashboard while a sync is
+        // in flight — saving a pre-call snapshot here would silently clobber that
+        // edit. Reading now closes the seconds-long network window; the residual
+        // sub-call window matches every other AgentService mutator.
+        const latest = await this.agentService.getConfig();
+        const appId = info.appId ?? appIdFromAppToken(latest.slack.appToken);
         return this.agentService.saveConfig({
-            ...agent,
+            ...latest,
             slack: {
-                ...agent.slack,
+                ...latest.slack,
                 ...info,
                 ...(appId ? { appId } : {}),
+                ...(botProfileSyncedAt ? { botProfileSyncedAt } : {}),
             },
         });
     }
@@ -151,7 +178,7 @@ export class AgentSlackService {
             throw new AgentConfigError(502, `Slack did not return a DM channel for ${owner.slackUserId}`);
         const mention = `<@${owner.slackUserId}>`;
         const ownerName = owner.displayName?.trim()
-            || operatorHandleLabel(owner.handle)
+            || ownerHandleLabel(owner.handle)
             || mention;
         const now = nowIso();
         const textLines = [
@@ -184,13 +211,23 @@ export class AgentSlackService {
 export function agentSlackServiceForAgent(agentId) {
     return new AgentSlackService(new AgentService(agentId));
 }
+// True when `iso` is a valid timestamp within `ttlMs` of now. Unset/unparseable
+// timestamps and a non-positive ttl are treated as stale so a sync still runs.
+function isWithinTtl(iso, ttlMs) {
+    if (!iso || ttlMs <= 0)
+        return false;
+    const then = Date.parse(iso);
+    if (Number.isNaN(then))
+        return false;
+    return Date.now() - then < ttlMs;
+}
 function requireBotToken(agent) {
     const token = agent.slack.botToken;
     if (!token)
         throw new AgentConfigError(400, `Agent ${agent.id} has no bot token configured`);
     return token;
 }
-function operatorHandleLabel(handle) {
+function ownerHandleLabel(handle) {
     const trimmed = handle?.trim();
     if (!trimmed)
         return undefined;

package/dist/server/agents/default-skills.d.ts

@@ -0,0 +1,9 @@
+export interface EnsureDefaultSkillsOptions {
+    homeDir?: string;
+}
+export interface EnsureDefaultSkillsResult {
+    claudeLinkInstalled: boolean;
+    commonSkillInstalled: boolean;
+}
+export declare function ensureDefaultSkills(options?: EnsureDefaultSkillsOptions): Promise<EnsureDefaultSkillsResult>;
+//# sourceMappingURL=default-skills.d.ts.map

package/dist/server/agents/default-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-skills.d.ts","sourceRoot":"","sources":["../../../server/agents/default-skills.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAMpC"}

package/dist/server/agents/default-skills.js

@@ -0,0 +1,52 @@
+import { lstat, mkdir, rm, stat, symlink, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join, relative } from 'node:path';
+import { readBundledTemplate } from '../bundled-templates.js';
+import { isMissingFile } from '../storage/json-file.js';
+const FIND_SKILLS_DIR = 'find-skills';
+const FIND_SKILLS_TEMPLATE = 'skills/find-skills/SKILL.md';
+export async function ensureDefaultSkills(options = {}) {
+    const homeDir = options.homeDir ?? homedir();
+    const commonSkillDir = join(homeDir, '.agents', 'skills', FIND_SKILLS_DIR);
+    const commonSkillInstalled = await ensureFindSkills(commonSkillDir);
+    const claudeLinkInstalled = await ensureClaudeFindSkillsLink(homeDir, commonSkillDir);
+    return { claudeLinkInstalled, commonSkillInstalled };
+}
+async function ensureFindSkills(skillDir) {
+    const skillPath = join(skillDir, 'SKILL.md');
+    if (await pathExists(skillPath))
+        return false;
+    await mkdir(skillDir, { recursive: true });
+    await writeFile(skillPath, await readBundledTemplate(FIND_SKILLS_TEMPLATE), 'utf8');
+    return true;
+}
+async function ensureClaudeFindSkillsLink(homeDir, commonSkillDir) {
+    const claudeSkillPath = join(homeDir, '.claude', 'skills', FIND_SKILLS_DIR);
+    const existing = await lstat(claudeSkillPath).catch((error) => {
+        if (isMissingFile(error))
+            return undefined;
+        throw error;
+    });
+    if (existing) {
+        if (existing.isSymbolicLink() && !(await pathExists(claudeSkillPath))) {
+            await rm(claudeSkillPath, { force: true });
+        }
+        else {
+            return false;
+        }
+    }
+    await mkdir(dirname(claudeSkillPath), { recursive: true });
+    await symlink(relative(dirname(claudeSkillPath), commonSkillDir), claudeSkillPath, 'dir');
+    return true;
+}
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return false;
+        throw error;
+    }
+}

package/dist/server/cli/runtime-cli.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from 'commander';
-import { type RuntimeInstallOptions, type RuntimeStatus } from '../runtime/managed-runtime.js';
+import { type RuntimeInstallOptions, type RuntimeStatus } from '../runtime-management/managed-runtime.js';
 import { type RuntimeUpgradeStatusResponse } from '../../shared/runtime-upgrade.js';
 interface RuntimeCliOptions {
     channel?: string;
@@ -10,6 +10,7 @@ interface RuntimeCliOptions {
     idleTimeoutMs?: number;
     logPath?: string;
     npm?: string;
+    browser?: boolean;
     only?: 'agent' | 'web';
     packageName?: string;
     previousStartedAt?: string;
@@ -29,5 +30,10 @@ export declare function runtimeInstallOptions(options: RuntimeCliOptions, defaul
 }): RuntimeInstallOptions;
 export declare function printRuntimeStatus(status: RuntimeStatus): void;
 export declare function printUpgradeStatus(status: RuntimeUpgradeStatusResponse): void;
+export declare function dashboardUrl(host: string, port: number): string;
+export declare function dashboardLaunchCommand(url: string, platform: NodeJS.Platform): {
+    command: string;
+    args: string[];
+};
 export {};
 //# sourceMappingURL=runtime-cli.d.ts.map

package/dist/server/cli/runtime-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../../../server/cli/runtime-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAOL,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAuB,KAAK,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAEzG,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK7D;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAMtE;AA6HD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,qBAAqB,CAQvB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAc9D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAgB7E"}
+{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../../../server/cli/runtime-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAOL,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EACnB,MAAM,0CAA0C,CAAC;AAMlD,OAAO,EAAuB,KAAK,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAEzG,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK7D;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAMtE;AAqID,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,qBAAqB,CAQvB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAc9D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAgB7E;AAuGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D;AA4CD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAIlH"}