agentikit 0.0.13 → 0.0.14

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-types.d.ts

@@ -1,227 +0,0 @@
-import type { AgentikitAssetType } from "./common";
-import type { RegistrySource } from "./registry-types";
-import type { ToolKind } from "./tool-runner";
-export type AgentikitSearchType = AgentikitAssetType | "any";
-export type SearchUsageMode = "none" | "both" | "item" | "guide";
-export type SearchSource = "local" | "registry" | "both";
-export interface LocalSearchHit {
-    hitSource: "local";
-    type: AgentikitAssetType;
-    name: string;
-    path: string;
-    openRef: string;
-    /** For installed sources, the registry id */
-    registryId?: string;
-    /** Whether this asset is editable (only true for working stash) */
-    editable?: boolean;
-    description?: string;
-    tags?: string[];
-    score?: number;
-    whyMatched?: string[];
-    runCmd?: string;
-    kind?: ToolKind;
-    usage?: string[];
-}
-export interface RegistrySearchResultHit {
-    hitSource: "registry";
-    type: "registry";
-    name: string;
-    path?: string;
-    openRef?: string;
-    id: string;
-    registrySource: RegistrySource;
-    ref: string;
-    description?: string;
-    tags?: string[];
-    homepage?: string;
-    score?: number;
-    whyMatched?: string[];
-    runCmd?: string;
-    kind?: ToolKind;
-    usage?: string[];
-    metadata?: Record<string, string>;
-    installRef: string;
-    installCmd: string;
-    /** Whether this entry was manually reviewed and approved */
-    curated?: boolean;
-}
-export type SearchHit = LocalSearchHit | RegistrySearchResultHit;
-export interface SearchResponse {
-    stashDir: string;
-    source: SearchSource;
-    hits: SearchHit[];
-    usageGuide?: Partial<Record<AgentikitAssetType, string[]>>;
-    tip?: string;
-    warnings?: string[];
-    /** Timing counters in milliseconds */
-    timing?: {
-        totalMs: number;
-        rankMs?: number;
-        embedMs?: number;
-    };
-}
-export interface AddResponse {
-    stashDir: string;
-    ref: string;
-    installed: {
-        id: string;
-        source: RegistrySource;
-        ref: string;
-        artifactUrl: string;
-        resolvedVersion?: string;
-        resolvedRevision?: string;
-        stashRoot: string;
-        cacheDir: string;
-        extractedDir: string;
-        installedAt: string;
-    };
-    config: {
-        mountedStashDirs: string[];
-        installedRegistryCount: number;
-    };
-    index: {
-        mode: "full" | "incremental";
-        totalEntries: number;
-        directoriesScanned: number;
-        directoriesSkipped: number;
-    };
-}
-export interface RegistryInstallStatus {
-    id: string;
-    source: RegistrySource;
-    ref: string;
-    artifactUrl: string;
-    resolvedVersion?: string;
-    resolvedRevision?: string;
-    stashRoot: string;
-    cacheDir: string;
-    extractedDir: string;
-    installedAt: string;
-}
-export interface RegistryListEntry {
-    id: string;
-    source: RegistrySource;
-    ref: string;
-    artifactUrl: string;
-    resolvedVersion?: string;
-    resolvedRevision?: string;
-    stashRoot: string;
-    cacheDir: string;
-    installedAt: string;
-    status: {
-        cacheDirExists: boolean;
-        stashRootExists: boolean;
-    };
-}
-export interface ListResponse {
-    stashDir: string;
-    installed: RegistryListEntry[];
-    totalInstalled: number;
-}
-export interface RemoveResponse {
-    stashDir: string;
-    target: string;
-    removed: {
-        id: string;
-        source: RegistrySource;
-        ref: string;
-        cacheDir: string;
-        stashRoot: string;
-    };
-    config: {
-        mountedStashDirs: string[];
-        installedRegistryCount: number;
-    };
-    index: {
-        mode: "full" | "incremental";
-        totalEntries: number;
-        directoriesScanned: number;
-        directoriesSkipped: number;
-    };
-}
-export interface ReinstallResultItem {
-    id: string;
-    source: RegistrySource;
-    ref: string;
-    previousCacheDir: string;
-    installed: RegistryInstallStatus;
-}
-export interface ReinstallResponse {
-    stashDir: string;
-    target?: string;
-    all: boolean;
-    processed: ReinstallResultItem[];
-    config: {
-        mountedStashDirs: string[];
-        installedRegistryCount: number;
-    };
-    index: {
-        mode: "full" | "incremental";
-        totalEntries: number;
-        directoriesScanned: number;
-        directoriesSkipped: number;
-    };
-}
-export interface UpdateResultItem {
-    id: string;
-    source: RegistrySource;
-    ref: string;
-    previous: {
-        resolvedVersion?: string;
-        resolvedRevision?: string;
-        cacheDir: string;
-    };
-    installed: RegistryInstallStatus;
-    changed: {
-        version: boolean;
-        revision: boolean;
-        any: boolean;
-    };
-}
-export interface UpdateResponse {
-    stashDir: string;
-    target?: string;
-    all: boolean;
-    processed: UpdateResultItem[];
-    config: {
-        mountedStashDirs: string[];
-        installedRegistryCount: number;
-    };
-    index: {
-        mode: "full" | "incremental";
-        totalEntries: number;
-        directoriesScanned: number;
-        directoriesSkipped: number;
-    };
-}
-export interface ShowResponse {
-    type: AgentikitAssetType;
-    name: string;
-    path: string;
-    content?: string;
-    template?: string;
-    prompt?: string;
-    description?: string;
-    toolPolicy?: unknown;
-    modelHint?: unknown;
-    runCmd?: string;
-    kind?: ToolKind;
-    /** For installed sources, the registry id */
-    registryId?: string;
-    /** Whether this asset is editable (only true for working stash) */
-    editable?: boolean;
-}
-export type KnowledgeView = {
-    mode: "full";
-} | {
-    mode: "toc";
-} | {
-    mode: "frontmatter";
-} | {
-    mode: "section";
-    heading: string;
-} | {
-    mode: "lines";
-    start: number;
-    end: number;
-};

package/dist/src/stash.d.ts

@@ -1,16 +0,0 @@
-export type { AgentikitAssetType } from "./common";
-export { resolveStashDir } from "./common";
-export { agentikitInit } from "./init";
-export type { InitResponse } from "./init";
-export type { ToolKind } from "./tool-runner";
-export type { AssetTypeHandler, ShowInput } from "./asset-type-handler";
-export { registerAssetType, getHandler, getAllHandlers, getRegisteredTypeNames } from "./asset-type-handler";
-export { agentikitSearch } from "./stash-search";
-export { agentikitShow } from "./stash-show";
-export { agentikitAdd } from "./stash-add";
-export { agentikitClone } from "./stash-clone";
-export { agentikitList, agentikitRemove, agentikitReinstall, agentikitUpdate } from "./stash-registry";
-export { resolveStashSources, resolveAllStashDirs, findSourceForPath } from "./stash-source";
-export type { StashSource, StashSourceKind } from "./stash-source";
-export type { AddResponse, AgentikitSearchType, LocalSearchHit, RegistrySearchResultHit, SearchSource, SearchUsageMode, SearchHit, SearchResponse, ShowResponse, KnowledgeView, ListResponse, RemoveResponse, ReinstallResponse, UpdateResponse, RegistryListEntry, RegistryInstallStatus, ReinstallResultItem, UpdateResultItem, } from "./stash-types";
-export type { CloneOptions, CloneResponse } from "./stash-clone";

package/dist/src/stash.js

@@ -1,9 +0,0 @@
-export { resolveStashDir } from "./common";
-export { agentikitInit } from "./init";
-export { registerAssetType, getHandler, getAllHandlers, getRegisteredTypeNames } from "./asset-type-handler";
-export { agentikitSearch } from "./stash-search";
-export { agentikitShow } from "./stash-show";
-export { agentikitAdd } from "./stash-add";
-export { agentikitClone } from "./stash-clone";
-export { agentikitList, agentikitRemove, agentikitReinstall, agentikitUpdate } from "./stash-registry";
-export { resolveStashSources, resolveAllStashDirs, findSourceForPath } from "./stash-source";

package/dist/src/tool-runner.d.ts

@@ -1,35 +0,0 @@
-/**
- * Tool execution utilities.
- *
- * Handles building run commands and executing tool scripts for all supported
- * kinds (bash, bun, powershell, cmd).
- */
-/** The supported tool execution kinds. */
-export type ToolKind = "bash" | "bun" | "powershell" | "cmd";
-export interface ToolExecution {
-    command: string;
-    args: string[];
-    cwd?: string;
-}
-export interface ToolInfo {
-    runCmd: string;
-    kind: ToolKind;
-    install?: ToolExecution;
-    execute: ToolExecution;
-}
-/**
- * Build execution metadata for a tool file based on its extension.
- *
- * For `.ts` / `.js` files, looks up the nearest `package.json` so that
- * `bun install` can be run in the correct working directory when the
- * `AKM_BUN_INSTALL` env flag is set.
- */
-export declare function buildToolInfo(stashDir: string, filePath: string): ToolInfo;
-/**
- * Shell-quote a path for inclusion in a human-readable `runCmd` string.
- */
-export declare function shellQuote(input: string): string;
-/**
- * Walk up from `startDir` toward `toolsRoot` looking for the nearest `package.json`.
- */
-export declare function findNearestPackageDir(startDir: string, toolsRoot: string): string | undefined;

package/dist/src/walker.d.ts

@@ -1,19 +0,0 @@
-/**
- * Shared filesystem walker for agentikit stash directories.
- *
- * Provides a single implementation used by both the search fallback
- * (stash.ts) and the indexer (indexer.ts) to walk type-specific asset
- * directories and group files by parent directory.
- */
-import { type AgentikitAssetType } from "./common";
-export interface DirectoryGroup {
-    dirPath: string;
-    files: string[];
-}
-/**
- * Walk a type root directory and return files grouped by their parent directory.
- *
- * Only files relevant to the given `assetType` are included (e.g. `.md` for
- * commands, script extensions for tools, `SKILL.md` for skills).
- */
-export declare function walkStash(typeRoot: string, assetType: AgentikitAssetType): DirectoryGroup[];

package/src/asset-spec.ts

@@ -1,85 +0,0 @@
-import path from "node:path"
-import type { AgentikitAssetType } from "./common"
-import { toPosix } from "./common"
-import { tryGetHandler } from "./asset-type-handler"
-
-export const SCRIPT_EXTENSIONS = new Set([".sh", ".ts", ".js", ".ps1", ".cmd", ".bat"])
-
-export interface AssetSpec {
-  stashDir: string
-  isRelevantFile: (fileName: string) => boolean
-  toCanonicalName: (typeRoot: string, filePath: string) => string | undefined
-  toAssetPath: (typeRoot: string, name: string) => string
-}
-
-const markdownSpec: Omit<AssetSpec, "stashDir"> = {
-  isRelevantFile: (fileName) => path.extname(fileName).toLowerCase() === ".md",
-  toCanonicalName: (typeRoot, filePath) => toPosix(path.relative(typeRoot, filePath)),
-  toAssetPath: (typeRoot, name) => path.join(typeRoot, name),
-}
-
-/** Extended set of script extensions for the script asset type */
-export const SCRIPT_EXTENSIONS_BROAD = new Set([
-  ...SCRIPT_EXTENSIONS,
-  ".py", ".rb", ".go", ".pl", ".php", ".lua", ".r", ".swift", ".kt", ".kts",
-])
-
-export const ASSET_SPECS: Record<AgentikitAssetType, AssetSpec> = {
-  tool: {
-    stashDir: "tools",
-    isRelevantFile: (fileName) => SCRIPT_EXTENSIONS.has(path.extname(fileName).toLowerCase()),
-    toCanonicalName: (typeRoot, filePath) => toPosix(path.relative(typeRoot, filePath)),
-    toAssetPath: (typeRoot, name) => path.join(typeRoot, name),
-  },
-  skill: {
-    stashDir: "skills",
-    isRelevantFile: (fileName) => fileName === "SKILL.md",
-    toCanonicalName: (typeRoot, filePath) => {
-      const relDir = toPosix(path.dirname(path.relative(typeRoot, filePath)))
-      if (!relDir || relDir === ".") return undefined
-      return relDir
-    },
-    toAssetPath: (typeRoot, name) => path.join(typeRoot, name, "SKILL.md"),
-  },
-  command: { stashDir: "commands", ...markdownSpec },
-  agent: { stashDir: "agents", ...markdownSpec },
-  knowledge: { stashDir: "knowledge", ...markdownSpec },
-  script: {
-    stashDir: "scripts",
-    isRelevantFile: (fileName) => SCRIPT_EXTENSIONS_BROAD.has(path.extname(fileName).toLowerCase()),
-    toCanonicalName: (typeRoot, filePath) => toPosix(path.relative(typeRoot, filePath)),
-    toAssetPath: (typeRoot, name) => path.join(typeRoot, name),
-  },
-}
-
-export const ASSET_TYPES = Object.keys(ASSET_SPECS) as AgentikitAssetType[]
-
-export const TYPE_DIRS: Record<AgentikitAssetType, string> = ASSET_TYPES.reduce(
-  (acc, type) => {
-    acc[type] = ASSET_SPECS[type].stashDir
-    return acc
-  },
-  {} as Record<AgentikitAssetType, string>,
-)
-
-export function isRelevantAssetFile(assetType: AgentikitAssetType, fileName: string): boolean {
-  const handler = tryGetHandler(assetType)
-  if (handler) return handler.isRelevantFile(fileName)
-  return ASSET_SPECS[assetType].isRelevantFile(fileName)
-}
-
-export function deriveCanonicalAssetName(
-  assetType: AgentikitAssetType,
-  typeRoot: string,
-  filePath: string,
-): string | undefined {
-  const handler = tryGetHandler(assetType)
-  if (handler) return handler.toCanonicalName(typeRoot, filePath)
-  return ASSET_SPECS[assetType].toCanonicalName(typeRoot, filePath)
-}
-
-export function resolveAssetPathFromName(assetType: AgentikitAssetType, typeRoot: string, name: string): string {
-  const handler = tryGetHandler(assetType)
-  if (handler) return handler.toAssetPath(typeRoot, name)
-  return ASSET_SPECS[assetType].toAssetPath(typeRoot, name)
-}

package/src/asset-type-handler.ts

@@ -1,77 +0,0 @@
-import type { StashEntry } from "./metadata"
-import type { LocalSearchHit, ShowResponse, KnowledgeView } from "./stash-types"
-
-// ── Interface ────────────────────────────────────────────────────────────────
-
-export interface ShowInput {
-  name: string
-  path: string
-  content: string
-  view?: KnowledgeView
-  stashDirs?: string[]
-}
-
-export interface AssetTypeHandler {
-  /** The type name, e.g. "tool", "script" */
-  readonly typeName: string
-  /** Directory inside the stash root, e.g. "tools", "scripts" */
-  readonly stashDir: string
-
-  // -- File system spec --
-  isRelevantFile(fileName: string): boolean
-  toCanonicalName(typeRoot: string, filePath: string): string | undefined
-  toAssetPath(typeRoot: string, name: string): string
-
-  // -- Show behavior --
-  buildShowResponse(input: ShowInput): ShowResponse
-
-  // -- Search enrichment --
-  enrichSearchHit?(hit: LocalSearchHit, stashDir: string): void
-
-  // -- Usage guide --
-  readonly defaultUsageGuide: string[]
-
-  // -- Metadata generation hooks --
-  extractTypeMetadata?(entry: StashEntry, file: string, ext: string): void
-}
-
-// ── Registry ─────────────────────────────────────────────────────────────────
-
-const handlers = new Map<string, AssetTypeHandler>()
-
-let handlersInitialized = false
-
-function ensureHandlersRegistered(): void {
-  if (handlersInitialized) return
-  handlersInitialized = true
-  // Import handler registrations
-  require("./handlers/index")
-}
-
-export function registerAssetType(handler: AssetTypeHandler): void {
-  handlers.set(handler.typeName, handler)
-}
-
-export function getHandler(type: string): AssetTypeHandler {
-  ensureHandlersRegistered()
-  const handler = handlers.get(type)
-  if (!handler) {
-    throw new Error(`Unknown asset type: "${type}"`)
-  }
-  return handler
-}
-
-export function tryGetHandler(type: string): AssetTypeHandler | undefined {
-  ensureHandlersRegistered()
-  return handlers.get(type)
-}
-
-export function getAllHandlers(): AssetTypeHandler[] {
-  ensureHandlersRegistered()
-  return Array.from(handlers.values())
-}
-
-export function getRegisteredTypeNames(): string[] {
-  ensureHandlersRegistered()
-  return Array.from(handlers.keys())
-}