@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/web/fetching/safe-fetcher.js

@@ -0,0 +1,64 @@
+import { isIP } from 'node:net';
+import { BlockedAddressError, FetchFailedError, TooManyRedirectsError, UnresolvedHostError, UnsupportedUrlError } from '../errors.js';
+import { isPublicAddress } from './address-policy.js';
+import { isRedirectStatus, isSuccessStatus } from './http-status.js';
+const MAX_REDIRECTS = 5;
+const HOP_TIMEOUT_MS = 20_000;
+const WEB_PROTOCOLS = ['http:', 'https:'];
+const BRACKETS = /^\[|\]$/g;
+function webUrl(url) {
+    if (!WEB_PROTOCOLS.includes(url.protocol)) {
+        throw new UnsupportedUrlError(url.protocol);
+    }
+    return url;
+}
+function redirectTarget(from, response) {
+    const { location } = response;
+    if (location === undefined || !URL.canParse(location, from.href)) {
+        throw new FetchFailedError(`HTTP ${String(response.status)} from ${from.hostname} redirected nowhere usable`);
+    }
+    return webUrl(new URL(location, from));
+}
+function pageFrom(url, response) {
+    if (!isSuccessStatus(response.status)) {
+        throw new FetchFailedError(`HTTP ${String(response.status)} from ${url.hostname}`);
+    }
+    return { finalUrl: url.href, contentType: response.contentType, text: response.text };
+}
+export class SafeFetcher {
+    resolver;
+    transport;
+    constructor(resolver, transport) {
+        this.resolver = resolver;
+        this.transport = transport;
+    }
+    async fetchText(url, signal) {
+        let target = webUrl(url);
+        for (let redirects = 0; redirects <= MAX_REDIRECTS; redirects++) {
+            signal.throwIfAborted();
+            const response = await this.requestOnce(target, signal);
+            if (!isRedirectStatus(response.status)) {
+                return pageFrom(target, response);
+            }
+            target = redirectTarget(target, response);
+        }
+        throw new TooManyRedirectsError(url.hostname, MAX_REDIRECTS);
+    }
+    async requestOnce(url, signal) {
+        const address = await this.checkedAddress(url);
+        return this.transport.get(url, address, AbortSignal.any([signal, AbortSignal.timeout(HOP_TIMEOUT_MS)]));
+    }
+    async checkedAddress(url) {
+        const host = url.hostname.replace(BRACKETS, '');
+        const addresses = isIP(host) === 0 ? await this.resolver.resolveAll(host) : [host];
+        const [first] = addresses;
+        if (first === undefined) {
+            throw new UnresolvedHostError(host);
+        }
+        if (!addresses.every(isPublicAddress)) {
+            throw new BlockedAddressError(host);
+        }
+        return first;
+    }
+}
+//# sourceMappingURL=safe-fetcher.js.map

package/dist/extensions/web/fetching/safe-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-fetcher.js","sourceRoot":"","sources":["../../../../src/extensions/web/fetching/safe-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtI,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASrE,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,aAAa,GAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,UAAU,CAAC;AAE5B,SAAS,MAAM,CAAC,GAAQ;IACtB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,IAAS,EAAE,QAAsB;IACvD,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAC9B,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,QAAQ,4BAA4B,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,GAAQ,EAAE,QAAsB;IAChD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,gBAAgB,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,OAAO,WAAW;IACL,QAAQ,CAAe;IACvB,SAAS,CAAgB;IAE1C,YAAY,QAAsB,EAAE,SAAwB;QAC1D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAQ,EAAE,MAAmB;QAC3C,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;YAChE,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvC,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC/D,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,GAAQ,EAAE,MAAmB;QACrD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1G,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,GAAQ;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnF,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/extensions/web/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function webExtension(pi: ExtensionAPI): void;

package/dist/extensions/web/index.js

@@ -0,0 +1,8 @@
+import { DnsHostResolver } from './fetching/host-resolver.js';
+import { PinnedHttpTransport } from './fetching/http-transport.js';
+import { SafeFetcher } from './fetching/safe-fetcher.js';
+import { registerWebTools } from './web-tools.js';
+export default function webExtension(pi) {
+    registerWebTools(pi, new SafeFetcher(new DnsHostResolver(), new PinnedHttpTransport()));
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/web/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAgB;IACnD,gBAAgB,CAAC,EAAE,EAAE,IAAI,WAAW,CAAC,IAAI,eAAe,EAAE,EAAE,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/extensions/web/web-schemas.d.ts

@@ -0,0 +1,10 @@
+import { Type } from 'typebox';
+export declare const WebSearchParams: Type.TObject<{
+    query: Type.TString;
+    allowed_domains: Type.TOptional<Type.TArray<Type.TString>>;
+    blocked_domains: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export declare const WebFetchParams: Type.TObject<{
+    url: Type.TString;
+    prompt: Type.TString;
+}>;

package/dist/extensions/web/web-schemas.js

@@ -0,0 +1,11 @@
+import { Type } from 'typebox';
+export const WebSearchParams = Type.Object({
+    query: Type.String({ description: 'The search query to use.' }),
+    allowed_domains: Type.Optional(Type.Array(Type.String(), { description: 'Only include results from these domains.' })),
+    blocked_domains: Type.Optional(Type.Array(Type.String(), { description: 'Never include results from these domains.' })),
+});
+export const WebFetchParams = Type.Object({
+    url: Type.String({ description: 'The absolute http or https URL to fetch.' }),
+    prompt: Type.String({ description: 'What to look for in the page.' }),
+});
+//# sourceMappingURL=web-schemas.js.map

package/dist/extensions/web/web-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-schemas.js","sourceRoot":"","sources":["../../../src/extensions/web/web-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;IAC/D,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC,CAAC;IACtH,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAAC;CACxH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;IAC7E,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC;CACtE,CAAC,CAAC"}

package/dist/extensions/web/web-tools.d.ts

@@ -0,0 +1,3 @@
+import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { type PageFetcher } from './fetching/duckduckgo-search.js';
+export declare function registerWebTools(pi: ExtensionAPI, fetcher: PageFetcher): void;

package/dist/extensions/web/web-tools.js

@@ -0,0 +1,53 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { textResult } from '../../kernel/tool-results/tool-result.js';
+import { UnsupportedUrlError } from './errors.js';
+import { filterByDomain } from './fetching/domain-filter.js';
+import { searchDuckDuckGo } from './fetching/duckduckgo-search.js';
+import { pageText } from './fetching/page-text.js';
+import { WebFetchParams, WebSearchParams } from './web-schemas.js';
+const MAX_SEARCH_RESULTS = 10;
+const NO_RESULTS_TEXT = 'No results found.';
+const WEB_SEARCH_DESCRIPTION = [
+    'Searches the web and returns titled results with their URLs and snippets.',
+    'Use allowed_domains to keep results from some domains only, or blocked_domains to drop some; when both are given, allowed_domains wins.',
+    'Read a result in full with WebFetch.',
+].join(' ');
+const WEB_FETCH_DESCRIPTION = [
+    'Fetches a web page and returns it as readable text, preceded by the prompt you gave.',
+    'Only absolute http and https URLs are fetched, and never a host that resolves to a private, loopback or link-local address.',
+    'Long pages are cut, and the result says how much was dropped.',
+].join(' ');
+const neverCancelled = (signal) => signal ?? new AbortController().signal;
+const numberedResults = (results) => results.map(({ title, url, snippet }, index) => `${String(index + 1)}. ${title}\n   ${url}\n   ${snippet}`).join('\n');
+function absoluteWebUrl(raw) {
+    if (!URL.canParse(raw)) {
+        throw new UnsupportedUrlError(raw);
+    }
+    return new URL(raw);
+}
+const webSearchTool = (fetcher) => defineTool({
+    name: 'WebSearch',
+    label: 'WebSearch',
+    description: WEB_SEARCH_DESCRIPTION,
+    parameters: WebSearchParams,
+    execute: async (_toolCallId, { query, allowed_domains, blocked_domains }, signal) => {
+        const found = await searchDuckDuckGo(query, fetcher, neverCancelled(signal));
+        const results = filterByDomain(found, allowed_domains, blocked_domains).slice(0, MAX_SEARCH_RESULTS);
+        return textResult(results.length === 0 ? NO_RESULTS_TEXT : numberedResults(results));
+    },
+});
+const webFetchTool = (fetcher) => defineTool({
+    name: 'WebFetch',
+    label: 'WebFetch',
+    description: WEB_FETCH_DESCRIPTION,
+    parameters: WebFetchParams,
+    execute: async (_toolCallId, { url, prompt }, signal) => {
+        const page = await fetcher.fetchText(absoluteWebUrl(url), neverCancelled(signal));
+        return textResult(`# ${prompt}\n\nSource: ${page.finalUrl}\n\n${pageText(page)}`);
+    },
+});
+export function registerWebTools(pi, fetcher) {
+    pi.registerTool(webSearchTool(fetcher));
+    pi.registerTool(webFetchTool(fetcher));
+}
+//# sourceMappingURL=web-tools.js.map

package/dist/extensions/web/web-tools.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { CLAUDE_CONFIG_DIR_VAR } from './kernel/claude-home/config-dir.js';
+export { cacheRoot, installIndexPath } from './kernel/claude-home/plugin-layout.js';
+export { isPackageReservedEnvKey, RESERVED_ENV_KEYS_VAR } from './kernel/claude-home/reserved-env-keys.js';
+export { userSettingsPath } from './kernel/claude-home/user-settings.js';
+export { AntharaError } from './errors/anthara-error.js';
+export { adoptInstall, type AdoptedInstall } from './kernel/plugin-install/adopt-install.js';
+export { CommandLineGit } from './kernel/plugin-install/command-line-git.js';
+export * from './kernel/plugin-install/errors.js';
+export type { GitClient } from './kernel/plugin-install/git-client.js';
+export { installRoot } from './kernel/plugin-install/install-layout.js';
+export { installedSourceOf, type InstalledSource, type InstallRecord } from './kernel/plugin-install/install-record.js';
+export { PluginInstaller } from './kernel/plugin-install/plugin-installer.js';
+export { isPluginName } from './kernel/plugin-install/plugin-manifest.js';
+export { looksLikeFullSha, toSha, type Sha } from './kernel/plugin-install/sha.js';
+export type { RenameDirectory } from './kernel/plugin-install/staging.js';
+export { runPluginSubcommand, type PluginCommandSetting } from './kernel/plugin-management/plugin-subcommands.js';
+export { removeWithin } from './kernel/private-files/confined-removal.js';
+export { MalformedConfigFileError } from './kernel/private-files/errors.js';
+export { ensurePrivateDirectory, isJsonObject, JSON_INDENT, OWNER_ONLY_DIRECTORY_MODE, OWNER_ONLY_FILE_MODE, parseJson, readJsonObject, readJsonObjectLeniently, writeJsonAtomically, type JsonObject, } from './kernel/private-files/private-files.js';
+export { runSubcommand, wrongArgumentsError, type SubcommandTable } from './kernel/subcommands/subcommand-table.js';

package/dist/index.js

@@ -0,0 +1,19 @@
+export { CLAUDE_CONFIG_DIR_VAR } from './kernel/claude-home/config-dir.js';
+export { cacheRoot, installIndexPath } from './kernel/claude-home/plugin-layout.js';
+export { isPackageReservedEnvKey, RESERVED_ENV_KEYS_VAR } from './kernel/claude-home/reserved-env-keys.js';
+export { userSettingsPath } from './kernel/claude-home/user-settings.js';
+export { AntharaError } from './errors/anthara-error.js';
+export { adoptInstall } from './kernel/plugin-install/adopt-install.js';
+export { CommandLineGit } from './kernel/plugin-install/command-line-git.js';
+export * from './kernel/plugin-install/errors.js';
+export { installRoot } from './kernel/plugin-install/install-layout.js';
+export { installedSourceOf } from './kernel/plugin-install/install-record.js';
+export { PluginInstaller } from './kernel/plugin-install/plugin-installer.js';
+export { isPluginName } from './kernel/plugin-install/plugin-manifest.js';
+export { looksLikeFullSha, toSha } from './kernel/plugin-install/sha.js';
+export { runPluginSubcommand } from './kernel/plugin-management/plugin-subcommands.js';
+export { removeWithin } from './kernel/private-files/confined-removal.js';
+export { MalformedConfigFileError } from './kernel/private-files/errors.js';
+export { ensurePrivateDirectory, isJsonObject, JSON_INDENT, OWNER_ONLY_DIRECTORY_MODE, OWNER_ONLY_FILE_MODE, parseJson, readJsonObject, readJsonObjectLeniently, writeJsonAtomically, } from './kernel/private-files/private-files.js';
+export { runSubcommand, wrongArgumentsError } from './kernel/subcommands/subcommand-table.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAuB,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,cAAc,mCAAmC,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAA4C,MAAM,2CAA2C,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAY,MAAM,gCAAgC,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAA6B,MAAM,kDAAkD,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,SAAS,EACT,cAAc,EACd,uBAAuB,EACvB,mBAAmB,GAEpB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAwB,MAAM,0CAA0C,CAAC"}

package/dist/kernel/agent-roster/agent-roster-slot.d.ts

@@ -0,0 +1,21 @@
+export interface MainAgentDefinition {
+    readonly id: string;
+    readonly systemPrompt: string;
+    readonly declaredModel?: string;
+    readonly tools?: readonly string[];
+    readonly disallowedTools: readonly string[];
+}
+export interface AgentRosterView {
+    ids(): readonly string[];
+    find(id: string): MainAgentDefinition;
+}
+type AgentRosterLookup = {
+    readonly kind: 'available';
+    readonly roster: AgentRosterView;
+} | {
+    readonly kind: 'unavailable';
+};
+export declare function publishAgentRoster(sessionId: string, roster: AgentRosterView): void;
+export declare function withdrawAgentRoster(sessionId: string): void;
+export declare function agentRosterFor(sessionId: string): AgentRosterLookup;
+export {};

package/dist/kernel/agent-roster/agent-roster-slot.js

@@ -0,0 +1,14 @@
+import { processSlot } from '../session-slots/process-slot.js';
+const UNAVAILABLE = { kind: 'unavailable' };
+const rostersBySession = () => processSlot('agent-roster', () => new Map());
+export function publishAgentRoster(sessionId, roster) {
+    rostersBySession().set(sessionId, roster);
+}
+export function withdrawAgentRoster(sessionId) {
+    rostersBySession().delete(sessionId);
+}
+export function agentRosterFor(sessionId) {
+    const roster = rostersBySession().get(sessionId);
+    return roster === undefined ? UNAVAILABLE : { kind: 'available', roster };
+}
+//# sourceMappingURL=agent-roster-slot.js.map

package/dist/kernel/agent-roster/agent-roster-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-roster-slot.js","sourceRoot":"","sources":["../../../src/kernel/agent-roster/agent-roster-slot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAiB/D,MAAM,WAAW,GAAsB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAE/D,MAAM,gBAAgB,GAAG,GAAiC,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAA2B,CAAC,CAAC;AAEnI,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,MAAuB;IAC3E,gBAAgB,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,gBAAgB,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC5E,CAAC"}

package/dist/kernel/agent-runner/agent-outcome.d.ts

@@ -0,0 +1,15 @@
+export interface CompletedRun {
+    readonly kind: 'completed';
+    readonly agent: string;
+    readonly model: string;
+    readonly text: string;
+    readonly keptWorktree?: string;
+}
+export interface FailedRun {
+    readonly kind: 'failed';
+    readonly agent: string;
+    readonly model: string;
+    readonly reason: string;
+    readonly keptWorktree?: string;
+}
+export type AgentOutcome = CompletedRun | FailedRun;

package/dist/kernel/agent-runner/agent-outcome.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-outcome.js.map

package/dist/kernel/agent-runner/agent-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-outcome.js","sourceRoot":"","sources":["../../../src/kernel/agent-runner/agent-outcome.ts"],"names":[],"mappings":""}

package/dist/kernel/agent-runner/agent-runner-slot.d.ts

@@ -0,0 +1,11 @@
+import type { SubAgentRunner } from './sub-agent-runner.js';
+type AgentRunnerLookup = {
+    readonly kind: 'available';
+    readonly runner: SubAgentRunner;
+} | {
+    readonly kind: 'unavailable';
+};
+export declare function publishAgentRunner(sessionId: string, runner: SubAgentRunner): void;
+export declare function withdrawAgentRunner(sessionId: string): void;
+export declare function agentRunnerFor(sessionId: string): AgentRunnerLookup;
+export {};

package/dist/kernel/agent-runner/agent-runner-slot.js

@@ -0,0 +1,14 @@
+import { processSlot } from '../session-slots/process-slot.js';
+const UNAVAILABLE = { kind: 'unavailable' };
+const runnersBySession = () => processSlot('agent-runner', () => new Map());
+export function publishAgentRunner(sessionId, runner) {
+    runnersBySession().set(sessionId, runner);
+}
+export function withdrawAgentRunner(sessionId) {
+    runnersBySession().delete(sessionId);
+}
+export function agentRunnerFor(sessionId) {
+    const runner = runnersBySession().get(sessionId);
+    return runner === undefined ? UNAVAILABLE : { kind: 'available', runner };
+}
+//# sourceMappingURL=agent-runner-slot.js.map

package/dist/kernel/agent-runner/agent-runner-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner-slot.js","sourceRoot":"","sources":["../../../src/kernel/agent-runner/agent-runner-slot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAK/D,MAAM,WAAW,GAAsB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAE/D,MAAM,gBAAgB,GAAG,GAAgC,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAA0B,CAAC,CAAC;AAEjI,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,MAAsB;IAC1E,gBAAgB,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,gBAAgB,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC5E,CAAC"}

package/dist/kernel/agent-runner/sub-agent-runner.d.ts

@@ -0,0 +1,19 @@
+import type { ExtensionContext, ExtensionToolContext } from '@earendil-works/pi-coding-agent';
+import type { AgentOutcome } from './agent-outcome.js';
+export type ParentContext = Pick<ExtensionContext, 'cwd' | 'model' | 'modelRegistry' | 'thinkingLevel'> & Partial<Pick<ExtensionToolContext, 'tools' | 'executeTool'>>;
+export interface SubAgentRequest {
+    readonly subagentType: string;
+    readonly description: string;
+    readonly prompt: string;
+    readonly model?: string;
+}
+export interface ReadOnlyAgentTask {
+    readonly name: string;
+    readonly systemPrompt: string;
+    readonly prompt: string;
+    readonly model?: string;
+}
+export interface SubAgentRunner {
+    run(request: SubAgentRequest, parent: ParentContext, signal: AbortSignal | undefined): Promise<AgentOutcome>;
+    runReadOnly(task: ReadOnlyAgentTask, parent: ParentContext, signal: AbortSignal | undefined): Promise<AgentOutcome>;
+}

package/dist/kernel/agent-runner/sub-agent-runner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sub-agent-runner.js.map

package/dist/kernel/agent-runner/sub-agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-runner.js","sourceRoot":"","sources":["../../../src/kernel/agent-runner/sub-agent-runner.ts"],"names":[],"mappings":""}

package/dist/kernel/agent-runner/sub-agent-tool-calls.d.ts

@@ -0,0 +1 @@
+export declare const isSubAgentToolCall: (toolCallId: string) => boolean;

package/dist/kernel/agent-runner/sub-agent-tool-calls.js

@@ -0,0 +1,4 @@
+// pi names a call that another tool made `<calling id>/<n>`, and in pi-claude only a sub-agent's bridged tools make such calls.
+const NESTED_CALL_ID_SEPARATOR = '/';
+export const isSubAgentToolCall = (toolCallId) => toolCallId.includes(NESTED_CALL_ID_SEPARATOR);
+//# sourceMappingURL=sub-agent-tool-calls.js.map

package/dist/kernel/agent-runner/sub-agent-tool-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-tool-calls.js","sourceRoot":"","sources":["../../../src/kernel/agent-runner/sub-agent-tool-calls.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAChI,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAkB,EAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/kernel/background-mailbox/background-mailbox.d.ts

@@ -0,0 +1,13 @@
+export interface BackgroundResult {
+    readonly customType: string;
+    readonly content: string;
+}
+export type Unsubscribe = () => void;
+type Deliver = (result: BackgroundResult) => void;
+export declare class BackgroundMailbox {
+    #private;
+    post(result: BackgroundResult): void;
+    subscribe(deliver: Deliver): Unsubscribe;
+}
+export declare const backgroundMailbox: () => BackgroundMailbox;
+export {};

package/dist/kernel/background-mailbox/background-mailbox.js

@@ -0,0 +1,38 @@
+import { processSlot } from '../session-slots/process-slot.js';
+export class BackgroundMailbox {
+    #subscriber;
+    #waiting = [];
+    post(result) {
+        this.#waiting.push(result);
+        this.#deliverWaiting();
+    }
+    subscribe(deliver) {
+        this.#subscriber = deliver;
+        this.#deliverWaiting();
+        return () => {
+            if (this.#subscriber === deliver) {
+                this.#subscriber = undefined;
+            }
+        };
+    }
+    #deliverWaiting() {
+        while (this.#subscriber !== undefined && this.#waiting.length > 0) {
+            this.#deliverFirst(this.#subscriber);
+        }
+    }
+    #deliverFirst(subscriber) {
+        const [result] = this.#waiting;
+        if (result === undefined) {
+            return;
+        }
+        try {
+            subscriber(result);
+            this.#waiting.shift();
+        }
+        catch {
+            this.#subscriber = undefined;
+        }
+    }
+}
+export const backgroundMailbox = () => processSlot('background-mailbox', () => new BackgroundMailbox());
+//# sourceMappingURL=background-mailbox.js.map

package/dist/kernel/background-mailbox/background-mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-mailbox.js","sourceRoot":"","sources":["../../../src/kernel/background-mailbox/background-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAW/D,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAsB;IACxB,QAAQ,GAAuB,EAAE,CAAC;IAE3C,IAAI,CAAC,MAAwB;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,SAAS,CAAC,OAAgB;QACxB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,aAAa,CAAC,UAAmB;QAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAsB,EAAE,CAAC,WAAW,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC"}

package/dist/kernel/claude-home/config-dir.d.ts

@@ -0,0 +1,2 @@
+export declare const CLAUDE_CONFIG_DIR_VAR = "CLAUDE_CONFIG_DIR";
+export declare function claudeConfigDir(env: NodeJS.ProcessEnv, userHome: string): string;

package/dist/kernel/claude-home/config-dir.js

@@ -0,0 +1,10 @@
+import { join, resolve } from 'node:path';
+export const CLAUDE_CONFIG_DIR_VAR = 'CLAUDE_CONFIG_DIR';
+const DEFAULT_CONFIG_DIRECTORY = '.claude';
+const HOME_PREFIX = '~';
+export function claudeConfigDir(env, userHome) {
+    const configured = env[CLAUDE_CONFIG_DIR_VAR] ?? '';
+    return configured.trim() === '' ? join(userHome, DEFAULT_CONFIG_DIRECTORY) : resolve(withHomeExpanded(configured, userHome));
+}
+const withHomeExpanded = (path, userHome) => path.startsWith(HOME_PREFIX) ? join(userHome, path.slice(HOME_PREFIX.length)) : path;
+//# sourceMappingURL=config-dir.js.map

package/dist/kernel/claude-home/config-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-dir.js","sourceRoot":"","sources":["../../../src/kernel/claude-home/config-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAC3C,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,GAAsB,EAAE,QAAgB;IACtE,MAAM,UAAU,GAAG,GAAG,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;IACpD,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/H,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAU,EAAE,CAClE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC"}

package/dist/kernel/claude-home/installed-plugins.d.ts

@@ -0,0 +1,10 @@
+interface InstalledPlugin {
+    readonly name: string;
+    readonly root: string;
+}
+export interface InstalledPluginEntry extends InstalledPlugin {
+    readonly directory: string;
+    readonly marketplace: string;
+}
+export declare function installedPluginEntries(claudeDir: string): InstalledPluginEntry[];
+export {};

package/dist/kernel/claude-home/installed-plugins.js

@@ -0,0 +1,64 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { isJsonObject, readJsonObjectLeniently } from '../private-files/private-files.js';
+import { cacheRoot, installIndexPath, marketplaceQualifiedId, PLUGIN_MANIFEST_PATH } from './plugin-layout.js';
+import { newestVersion } from './plugin-versions.js';
+const ORPHANED_MARKER = '.orphaned_at';
+const USER_SCOPE = 'user';
+// The plugins Claude Code installed, found by walking its plugin cache, each with the cache directory and marketplace it
+// was found under, which name it in `enabledPlugins`. The directory may be Claude Code's own (the bare pi-claude
+// package), so its install index is read leniently: an entry anthara did not write, or an index nobody can parse, is
+// never an error. Enablement is not applied: a plugin turned off in settings is still listed.
+export function installedPluginEntries(claudeDir) {
+    const recorded = recordedInstallPaths(claudeDir);
+    const cache = resolve(cacheRoot(claudeDir));
+    return directoriesIn(cache).flatMap((marketplace) => pluginDirectoriesIn(join(cache, marketplace)).flatMap((pluginDir) => loadedPlugin(join(cache, marketplace, pluginDir), recorded.get(marketplaceQualifiedId(pluginDir, marketplace)) ?? []).map((plugin) => ({ ...plugin, directory: pluginDir, marketplace }))));
+}
+// per plugin id, every recorded installPath, user scope first; either layout (a list, or the older single object)
+function recordedInstallPaths(claudeDir) {
+    const { plugins } = readJsonObjectLeniently(installIndexPath(claudeDir));
+    if (!isJsonObject(plugins)) {
+        return new Map();
+    }
+    return new Map(Object.entries(plugins).map(([id, installs]) => [id, installPathsOf(installs)]));
+}
+function installPathsOf(installs) {
+    const listed = Array.isArray(installs) ? installs : [installs];
+    return listed
+        .filter(isRecordedInstall)
+        .sort((a, b) => Number(b.scope === USER_SCOPE) - Number(a.scope === USER_SCOPE))
+        .map(({ installPath }) => installPath);
+}
+const isRecordedInstall = (install) => isJsonObject(install) && typeof install.installPath === 'string';
+function loadedPlugin(pluginPath, recorded) {
+    return loadedVersionDir(pluginPath, recorded).map((root) => ({ name: pluginNameIn(root, basename(pluginPath)), root }));
+}
+// a record counts only when it names an existing version directly under this plugin's cache directory
+function loadedVersionDir(pluginPath, recorded) {
+    const versions = directoriesIn(pluginPath);
+    const installed = recorded.find((dir) => dirname(resolve(dir)) === pluginPath && versions.includes(basename(dir)));
+    if (installed !== undefined) {
+        return [installed];
+    }
+    const live = versions.filter((version) => !existsSync(join(pluginPath, version, ORPHANED_MARKER)));
+    return newestVersion(live).map((version) => join(pluginPath, version));
+}
+function pluginNameIn(root, directoryName) {
+    const { name } = readJsonObjectLeniently(join(root, PLUGIN_MANIFEST_PATH));
+    return typeof name === 'string' && name.length > 0 ? name : directoryName;
+}
+// a dot-directory is never a plugin: Claude Code clones a marketplace into one first
+const pluginDirectoriesIn = (marketplaceDir) => directoriesIn(marketplaceDir).filter((name) => !name.startsWith('.'));
+// real directories only, as Claude Code lists them: a symlinked plugin or version is not loaded
+function directoriesIn(directory) {
+    try {
+        return readdirSync(directory, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=installed-plugins.js.map

package/dist/kernel/claude-home/installed-plugins.js.map

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

package/dist/kernel/claude-home/plugin-layout.d.ts

@@ -0,0 +1,6 @@
+export declare const CACHE_PATH_SEGMENTS: readonly ["plugins", "cache"];
+export declare const PLUGIN_MANIFEST_PATH: string;
+export declare function cacheRoot(claudeDir: string): string;
+export declare function installIndexPath(claudeDir: string): string;
+export declare function pluginDataDir(claudeDir: string, qualifiedId: string): string;
+export declare function marketplaceQualifiedId(plugin: string, marketplace: string): string;

package/dist/kernel/claude-home/plugin-layout.js

@@ -0,0 +1,20 @@
+import { join } from 'node:path';
+const PLUGINS_DIRECTORY = 'plugins';
+const QUALIFIER_SEPARATOR = '@';
+export const CACHE_PATH_SEGMENTS = [PLUGINS_DIRECTORY, 'cache'];
+export const PLUGIN_MANIFEST_PATH = join('.claude-plugin', 'plugin.json');
+export function cacheRoot(claudeDir) {
+    return join(claudeDir, ...CACHE_PATH_SEGMENTS);
+}
+export function installIndexPath(claudeDir) {
+    return join(claudeDir, PLUGINS_DIRECTORY, 'installed_plugins.json');
+}
+// Claude names a plugin's persistent data folder by its id with every character outside a-z, A-Z, 0-9, _ and - as a dash
+export function pluginDataDir(claudeDir, qualifiedId) {
+    return join(claudeDir, PLUGINS_DIRECTORY, 'data', qualifiedId.replace(/[^A-Za-z0-9_-]/g, '-'));
+}
+// Claude Code names a plugin of any marketplace <plugin>@<marketplace>, in the install index and in enabledPlugins
+export function marketplaceQualifiedId(plugin, marketplace) {
+    return `${plugin}${QUALIFIER_SEPARATOR}${marketplace}`;
+}
+//# sourceMappingURL=plugin-layout.js.map

package/dist/kernel/claude-home/plugin-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-layout.js","sourceRoot":"","sources":["../../../src/kernel/claude-home/plugin-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AACpC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAU,CAAC;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAE1E,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,IAAI,CAAC,SAAS,EAAE,GAAG,mBAAmB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,wBAAwB,CAAC,CAAC;AACtE,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,WAAmB;IAClE,OAAO,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,WAAmB;IACxE,OAAO,GAAG,MAAM,GAAG,mBAAmB,GAAG,WAAW,EAAE,CAAC;AACzD,CAAC"}

package/dist/kernel/claude-home/plugin-versions.d.ts

@@ -0,0 +1 @@
+export declare function newestVersion(versions: readonly string[]): string[];

package/dist/kernel/claude-home/plugin-versions.js

@@ -0,0 +1,38 @@
+const RELEASE_SEPARATOR = '-';
+// Claude Code's choice among a plugin's version directories when no install record names one: 1.10.0 above 1.9.0, a
+// leading "v" ignored, and a release above its own prerelease. Empty when there is no version to choose.
+export function newestVersion(versions) {
+    return [...versions].sort(compareVersions).slice(-1);
+}
+function compareVersions(a, b) {
+    const left = parseVersion(a);
+    const right = parseVersion(b);
+    return compareBase(left.base, right.base) || comparePrerelease(left.prerelease, right.prerelease);
+}
+function parseVersion(version) {
+    const stripped = version.replace(/^v/i, '');
+    const separator = stripped.indexOf(RELEASE_SEPARATOR);
+    if (separator === -1) {
+        return { base: baseNumbers(stripped) };
+    }
+    return { base: baseNumbers(stripped.slice(0, separator)), prerelease: stripped.slice(separator + 1) };
+}
+const baseNumbers = (base) => base.split('.').map((segment) => Number.parseInt(segment, 10) || 0);
+function compareBase(left, right) {
+    const length = Math.max(left.length, right.length);
+    const differences = Array.from({ length }, (_, index) => (left[index] ?? 0) - (right[index] ?? 0));
+    return differences.find((difference) => difference !== 0) ?? 0;
+}
+function comparePrerelease(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    if (left === undefined) {
+        return 1;
+    }
+    if (right === undefined) {
+        return -1;
+    }
+    return left.localeCompare(right, 'en', { numeric: true });
+}
+//# sourceMappingURL=plugin-versions.js.map