agentikit 0.0.13 → 0.0.15

package/dist/src/registry-search.d.ts

@@ -1,27 +0,0 @@
-import type { RegistrySearchResponse } from "./registry-types";
-export interface RegistryIndex {
-    version: number;
-    updatedAt: string;
-    kits: RegistryKitEntry[];
-}
-export interface RegistryKitEntry {
-    id: string;
-    name: string;
-    description?: string;
-    ref: string;
-    source: "npm" | "github" | "git";
-    homepage?: string;
-    tags?: string[];
-    assetTypes?: string[];
-    author?: string;
-    license?: string;
-    latestVersion?: string;
-    /** Whether this entry was manually reviewed and approved */
-    curated?: boolean;
-}
-export interface RegistrySearchOptions {
-    limit?: number;
-    /** Override registry URL(s). Accepts a single URL or an array. */
-    registryUrls?: string | string[];
-}
-export declare function searchRegistry(query: string, options?: RegistrySearchOptions): Promise<RegistrySearchResponse>;

package/dist/src/registry-types.d.ts

@@ -1,62 +0,0 @@
-export type RegistrySource = "npm" | "github" | "git";
-export interface RegistryRefBase {
-    source: RegistrySource;
-    ref: string;
-    id: string;
-}
-export interface ParsedNpmRef extends RegistryRefBase {
-    source: "npm";
-    packageName: string;
-    requestedVersionOrTag?: string;
-}
-export interface ParsedGithubRef extends RegistryRefBase {
-    source: "github";
-    owner: string;
-    repo: string;
-    requestedRef?: string;
-}
-export interface ParsedGitRef extends RegistryRefBase {
-    source: "git";
-    repoRoot: string;
-    sourcePath: string;
-}
-export type ParsedRegistryRef = ParsedNpmRef | ParsedGithubRef | ParsedGitRef;
-export interface ResolvedRegistryArtifact {
-    id: string;
-    source: RegistrySource;
-    ref: string;
-    artifactUrl: string;
-    resolvedVersion?: string;
-    resolvedRevision?: string;
-}
-export interface RegistryInstalledEntry {
-    id: string;
-    source: RegistrySource;
-    ref: string;
-    resolvedVersion?: string;
-    resolvedRevision?: string;
-    artifactUrl: string;
-    stashRoot: string;
-    cacheDir: string;
-    installedAt: string;
-}
-export interface RegistryInstallResult extends RegistryInstalledEntry {
-    extractedDir: string;
-}
-export interface RegistrySearchHit {
-    source: RegistrySource;
-    id: string;
-    title: string;
-    description?: string;
-    ref: string;
-    homepage?: string;
-    score?: number;
-    metadata?: Record<string, string>;
-    /** Whether this entry was manually reviewed and approved */
-    curated?: boolean;
-}
-export interface RegistrySearchResponse {
-    query: string;
-    hits: RegistrySearchHit[];
-    warnings: string[];
-}

package/dist/src/ripgrep-install.d.ts

@@ -1,12 +0,0 @@
-export interface EnsureRgResult {
-    rgPath: string;
-    installed: boolean;
-    version: string;
-}
-/**
- * Ensure ripgrep is available. If not found on PATH or in stash/bin,
- * download and install it to stash/bin.
- *
- * Returns the path to the ripgrep binary and whether it was newly installed.
- */
-export declare function ensureRg(stashDir: string): EnsureRgResult;

package/dist/src/ripgrep-resolve.d.ts

@@ -1,13 +0,0 @@
-export declare const RG_BINARY: string;
-/**
- * Resolve the path to a usable ripgrep binary.
- * Checks in order:
- *   1. stashDir/bin/rg
- *   2. system PATH (rg)
- * Returns null if ripgrep is not available.
- */
-export declare function resolveRg(stashDir?: string): string | null;
-/**
- * Check if ripgrep is available (either in stash/bin or system PATH).
- */
-export declare function isRgAvailable(stashDir?: string): boolean;

package/dist/src/ripgrep.d.ts

@@ -1,3 +0,0 @@
-export { resolveRg, isRgAvailable } from "./ripgrep-resolve";
-export { ensureRg } from "./ripgrep-install";
-export type { EnsureRgResult } from "./ripgrep-install";

package/dist/src/ripgrep.js

@@ -1,2 +0,0 @@
-export { resolveRg, isRgAvailable } from "./ripgrep-resolve";
-export { ensureRg } from "./ripgrep-install";

package/dist/src/stash-add.d.ts

@@ -1,4 +0,0 @@
-import type { AddResponse } from "./stash-types";
-export declare function agentikitAdd(input: {
-    ref: string;
-}): Promise<AddResponse>;

package/dist/src/stash-clone.d.ts

@@ -1,22 +0,0 @@
-import { type StashSourceKind } from "./stash-source";
-export interface CloneOptions {
-    /** Source ref (e.g., npm:@scope/pkg//tool:deploy.sh) */
-    sourceRef: string;
-    /** Optional new name for the cloned asset */
-    newName?: string;
-    /** If true, overwrite existing asset in working stash */
-    force?: boolean;
-}
-export interface CloneResponse {
-    source: {
-        path: string;
-        sourceKind: StashSourceKind;
-        registryId?: string;
-    };
-    destination: {
-        path: string;
-        ref: string;
-    };
-    overwritten: boolean;
-}
-export declare function agentikitClone(options: CloneOptions): Promise<CloneResponse>;

package/dist/src/stash-clone.js

@@ -1,83 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { TYPE_DIRS } from "./asset-spec";
-import { parseAssetRef, makeAssetRef } from "./stash-ref";
-import { resolveSourcesForOrigin } from "./origin-resolve";
-import { resolveAssetPath } from "./stash-resolve";
-import { resolveStashSources, findSourceForPath } from "./stash-source";
-export async function agentikitClone(options) {
-    const parsed = parseAssetRef(options.sourceRef);
-    const allSources = resolveStashSources();
-    const workingSource = allSources.find((s) => s.kind === "working");
-    if (!workingSource) {
-        throw new Error("No working stash configured. Run `akm init` first.");
-    }
-    const searchSources = resolveSourcesForOrigin(parsed.origin, allSources);
-    let sourcePath;
-    let lastError;
-    for (const source of searchSources) {
-        try {
-            sourcePath = resolveAssetPath(source.path, parsed.type, parsed.name);
-            break;
-        }
-        catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-        }
-    }
-    if (!sourcePath) {
-        throw lastError ?? new Error(`Source asset not found for ref: ${options.sourceRef}`);
-    }
-    const sourceSource = findSourceForPath(sourcePath, allSources);
-    const sourceKind = sourceSource?.kind ?? "working";
-    const destName = options.newName ?? parsed.name;
-    const typeDir = TYPE_DIRS[parsed.type];
-    const workingDir = workingSource.path;
-    // Guard against self-clone
-    if (parsed.type === "skill") {
-        const sourceSkillDir = path.resolve(path.dirname(sourcePath));
-        const destSkillDir = path.resolve(path.join(workingDir, typeDir, destName));
-        if (sourceSkillDir === destSkillDir) {
-            throw new Error(`Source and destination are the same path. Use --name to provide a new name for the clone.`);
-        }
-    }
-    else {
-        const resolvedSource = path.resolve(sourcePath);
-        const resolvedDest = path.resolve(path.join(workingDir, typeDir, destName));
-        if (resolvedSource === resolvedDest) {
-            throw new Error(`Source and destination are the same path. Use --name to provide a new name for the clone.`);
-        }
-    }
-    let destPath;
-    if (parsed.type === "skill") {
-        const sourceSkillDir = path.dirname(sourcePath);
-        const destSkillDir = path.join(workingDir, typeDir, destName);
-        const overwritten = fs.existsSync(destSkillDir);
-        if (overwritten && !options.force) {
-            throw new Error(`Asset already exists in working stash: ${destSkillDir}. Use --force to overwrite.`);
-        }
-        if (overwritten) {
-            fs.rmSync(destSkillDir, { recursive: true, force: true });
-        }
-        fs.cpSync(sourceSkillDir, destSkillDir, { recursive: true });
-        destPath = path.join(destSkillDir, "SKILL.md");
-        const ref = makeAssetRef(parsed.type, destName, "local");
-        return {
-            source: { path: sourcePath, sourceKind, registryId: sourceSource?.registryId },
-            destination: { path: destPath, ref },
-            overwritten,
-        };
-    }
-    destPath = path.join(workingDir, typeDir, destName);
-    const overwritten = fs.existsSync(destPath);
-    if (overwritten && !options.force) {
-        throw new Error(`Asset already exists in working stash: ${destPath}. Use --force to overwrite.`);
-    }
-    fs.mkdirSync(path.dirname(destPath), { recursive: true });
-    fs.copyFileSync(sourcePath, destPath);
-    const ref = makeAssetRef(parsed.type, destName, "local");
-    return {
-        source: { path: sourcePath, sourceKind, registryId: sourceSource?.registryId },
-        destination: { path: destPath, ref },
-        overwritten,
-    };
-}

package/dist/src/stash-ref.d.ts

@@ -1,31 +0,0 @@
-import { type AgentikitAssetType } from "./common";
-export interface AssetRef {
-    type: AgentikitAssetType;
-    name: string;
-    /**
-     * Where to find this asset.
-     *   - undefined: search all sources (working → mounted → installed)
-     *   - "local": working stash only
-     *   - registry ref: e.g. "npm:@scope/pkg", "owner/repo", "github:owner/repo#v1"
-     *   - filesystem path: e.g. "/mnt/shared-stash"
-     */
-    origin?: string;
-}
-/**
- * Build a ref string from components.
- *
- * Examples:
- *   makeAssetRef("tool", "deploy.sh")
- *     → "tool:deploy.sh"
- *   makeAssetRef("tool", "deploy.sh", "npm:@scope/pkg")
- *     → "npm:@scope/pkg//tool:deploy.sh"
- *   makeAssetRef("skill", "code-review", "local")
- *     → "local//skill:code-review"
- *   makeAssetRef("tool", "db/migrate/run.sh", "owner/repo")
- *     → "owner/repo//tool:db/migrate/run.sh"
- */
-export declare function makeAssetRef(type: AgentikitAssetType, name: string, origin?: string): string;
-/**
- * Parse a ref string in the format `[origin//]type:name`.
- */
-export declare function parseAssetRef(ref: string): AssetRef;

package/dist/src/stash-registry.d.ts

@@ -1,18 +0,0 @@
-import type { ListResponse, RemoveResponse, ReinstallResponse, UpdateResponse } from "./stash-types";
-export declare function agentikitList(input?: {
-    stashDir?: string;
-}): Promise<ListResponse>;
-export declare function agentikitRemove(input: {
-    target: string;
-    stashDir?: string;
-}): Promise<RemoveResponse>;
-export declare function agentikitReinstall(input?: {
-    target?: string;
-    all?: boolean;
-    stashDir?: string;
-}): Promise<ReinstallResponse>;
-export declare function agentikitUpdate(input?: {
-    target?: string;
-    all?: boolean;
-    stashDir?: string;
-}): Promise<UpdateResponse>;

package/dist/src/stash-resolve.d.ts

@@ -1,2 +0,0 @@
-import { type AgentikitAssetType } from "./common";
-export declare function resolveAssetPath(stashDir: string, type: AgentikitAssetType, name: string): string;

package/dist/src/stash-search.d.ts

@@ -1,8 +0,0 @@
-import type { AgentikitSearchType, SearchResponse, SearchSource, SearchUsageMode } from "./stash-types";
-export declare function agentikitSearch(input: {
-    query: string;
-    type?: AgentikitSearchType;
-    limit?: number;
-    usage?: SearchUsageMode;
-    source?: SearchSource;
-}): Promise<SearchResponse>;

package/dist/src/stash-show.d.ts

@@ -1,5 +0,0 @@
-import type { KnowledgeView, ShowResponse } from "./stash-types";
-export declare function agentikitShow(input: {
-    ref: string;
-    view?: KnowledgeView;
-}): Promise<ShowResponse>;

package/dist/src/stash-show.js

@@ -1,46 +0,0 @@
-import fs from "node:fs";
-import { parseAssetRef } from "./stash-ref";
-import { resolveSourcesForOrigin } from "./origin-resolve";
-import { resolveAssetPath } from "./stash-resolve";
-import { getHandler } from "./asset-type-handler";
-import { resolveStashSources, findSourceForPath } from "./stash-source";
-export async function agentikitShow(input) {
-    const parsed = parseAssetRef(input.ref);
-    const allSources = resolveStashSources();
-    const searchSources = resolveSourcesForOrigin(parsed.origin, allSources);
-    const allStashDirs = searchSources.map((s) => s.path);
-    let assetPath;
-    let lastError;
-    for (const dir of allStashDirs) {
-        try {
-            assetPath = resolveAssetPath(dir, parsed.type, parsed.name);
-            break;
-        }
-        catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-        }
-    }
-    if (!assetPath && parsed.origin && searchSources.length === 0) {
-        const installCmd = `akm add ${parsed.origin}`;
-        throw new Error(`Stash asset not found for ref: ${parsed.type}:${parsed.name}. ` +
-            `Kit "${parsed.origin}" is not installed. Run: ${installCmd}`);
-    }
-    if (!assetPath) {
-        throw lastError ?? new Error(`Stash asset not found for ref: ${parsed.type}:${parsed.name}`);
-    }
-    const content = fs.readFileSync(assetPath, "utf8");
-    const source = findSourceForPath(assetPath, allSources);
-    const handler = getHandler(parsed.type);
-    const response = handler.buildShowResponse({
-        name: parsed.name,
-        path: assetPath,
-        content,
-        view: input.view,
-        stashDirs: allStashDirs,
-    });
-    return {
-        ...response,
-        registryId: source?.registryId,
-        editable: source?.writable ?? false,
-    };
-}

package/dist/src/stash-source.d.ts

@@ -1,24 +0,0 @@
-export type StashSourceKind = "working" | "mounted" | "installed";
-export interface StashSource {
-    kind: StashSourceKind;
-    path: string;
-    /** For installed sources, the registry entry id */
-    registryId?: string;
-    /** Whether this source is writable (only working stash) */
-    writable: boolean;
-}
-/**
- * Build the ordered list of stash sources:
- *   1. Working stash (writable)
- *   2. Mounted stash dirs (read-only, user-configured)
- *   3. Installed stash dirs (read-only, derived from registry.installed)
- */
-export declare function resolveStashSources(overrideStashDir?: string): StashSource[];
-/**
- * Convenience: returns just the directory paths, preserving priority order.
- */
-export declare function resolveAllStashDirs(overrideStashDir?: string): string[];
-/**
- * Find which source a file path belongs to.
- */
-export declare function findSourceForPath(filePath: string, sources: StashSource[]): StashSource | undefined;

package/dist/src/stash-source.js

@@ -1,81 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { resolveStashDir } from "./common";
-import { loadConfig } from "./config";
-// ── Resolution ──────────────────────────────────────────────────────────────
-/**
- * Build the ordered list of stash sources:
- *   1. Working stash (writable)
- *   2. Mounted stash dirs (read-only, user-configured)
- *   3. Installed stash dirs (read-only, derived from registry.installed)
- */
-export function resolveStashSources(overrideStashDir) {
-    const stashDir = overrideStashDir ?? resolveStashDir();
-    const config = loadConfig();
-    const sources = [
-        { kind: "working", path: stashDir, writable: true },
-    ];
-    for (const dir of config.mountedStashDirs) {
-        if (isSuspiciousStashRoot(dir)) {
-            console.warn(`Warning: stash root "${dir}" appears to be a system directory. This may be unintentional.`);
-        }
-        if (isValidDirectory(dir)) {
-            sources.push({ kind: "mounted", path: dir, writable: false });
-        }
-    }
-    for (const entry of config.registry?.installed ?? []) {
-        if (isSuspiciousStashRoot(entry.stashRoot)) {
-            console.warn(`Warning: stash root "${entry.stashRoot}" appears to be a system directory. This may be unintentional.`);
-        }
-        if (isValidDirectory(entry.stashRoot)) {
-            sources.push({
-                kind: "installed",
-                path: entry.stashRoot,
-                registryId: entry.id,
-                writable: false,
-            });
-        }
-    }
-    return sources;
-}
-/**
- * Convenience: returns just the directory paths, preserving priority order.
- */
-export function resolveAllStashDirs(overrideStashDir) {
-    return resolveStashSources(overrideStashDir).map((s) => s.path);
-}
-/**
- * Find which source a file path belongs to.
- */
-export function findSourceForPath(filePath, sources) {
-    const resolved = path.resolve(filePath);
-    for (const source of sources) {
-        if (resolved.startsWith(path.resolve(source.path) + path.sep))
-            return source;
-    }
-    return undefined;
-}
-// ── Validation ──────────────────────────────────────────────────────────────
-const SUSPICIOUS_ROOTS = new Set(['/', '/etc', '/bin', '/sbin', '/usr', '/var', '/tmp', '/dev', '/proc', '/sys']);
-function isSuspiciousStashRoot(dir) {
-    const resolved = path.resolve(dir);
-    const normalized = process.platform === 'win32' ? resolved.toLowerCase() : resolved;
-    if (SUSPICIOUS_ROOTS.has(normalized))
-        return true;
-    if (process.platform === 'win32') {
-        // Check for Windows system directories
-        const winDir = (process.env.SystemRoot || 'C:\\Windows').toLowerCase();
-        if (normalized === winDir || normalized.startsWith(winDir + path.sep))
-            return true;
-    }
-    return false;
-}
-// ── Helpers ─────────────────────────────────────────────────────────────────
-function isValidDirectory(dir) {
-    try {
-        return fs.statSync(dir).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}