agentikit 0.0.13 → 0.0.14

package/src/stash-source.ts

@@ -1,103 +0,0 @@
-import fs from "node:fs"
-import path from "node:path"
-import { resolveStashDir } from "./common"
-import { loadConfig } from "./config"
-
-// ── Types ───────────────────────────────────────────────────────────────────
-
-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
-}
-
-// ── 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?: string): StashSource[] {
-  const stashDir = overrideStashDir ?? resolveStashDir()
-  const config = loadConfig()
-
-  const sources: StashSource[] = [
-    { 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?: string): string[] {
-  return resolveStashSources(overrideStashDir).map((s) => s.path)
-}
-
-/**
- * Find which source a file path belongs to.
- */
-export function findSourceForPath(filePath: string, sources: StashSource[]): StashSource | undefined {
-  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: string): boolean {
-  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: string): boolean {
-  try {
-    return fs.statSync(dir).isDirectory()
-  } catch {
-    return false
-  }
-}

package/src/stash-types.ts

@@ -1,231 +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/src/stash.ts

@@ -1,39 +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/src/tool-runner.ts

@@ -1,142 +0,0 @@
-/**
- * Tool execution utilities.
- *
- * Handles building run commands and executing tool scripts for all supported
- * kinds (bash, bun, powershell, cmd).
- */
-
-import fs from "node:fs"
-import path from "node:path"
-import { IS_WINDOWS, isWithin } from "./common"
-
-// ── Types ───────────────────────────────────────────────────────────────────
-
-/** 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
-}
-
-// ── Public API ──────────────────────────────────────────────────────────────
-
-/**
- * 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 function buildToolInfo(stashDir: string, filePath: string): ToolInfo {
-  const ext = path.extname(filePath).toLowerCase()
-
-  if (ext === ".sh") {
-    return {
-      runCmd: `bash ${shellQuote(filePath)}`,
-      kind: "bash",
-      execute: { command: "bash", args: [filePath] },
-    }
-  }
-
-  if (ext === ".ps1") {
-    return {
-      runCmd: `powershell -ExecutionPolicy Bypass -File ${shellQuote(filePath)}`,
-      kind: "powershell",
-      execute: { command: "powershell", args: ["-ExecutionPolicy", "Bypass", "-File", filePath] },
-    }
-  }
-
-  if (ext === ".cmd" || ext === ".bat") {
-    return {
-      runCmd: `cmd /c ${shellQuote(filePath)}`,
-      kind: "cmd",
-      execute: { command: "cmd", args: ["/c", filePath] },
-    }
-  }
-
-  if (ext !== ".ts" && ext !== ".js") {
-    throw new Error(`Unsupported tool extension: ${ext}`)
-  }
-
-  // Determine the type root by checking which subdirectory contains the file
-  const resolvedFile = path.resolve(filePath)
-  let typeRoot = path.resolve(path.join(stashDir, "tools"))
-  for (const subdir of ["tools", "scripts"]) {
-    const candidate = path.resolve(path.join(stashDir, subdir))
-    if (resolvedFile.startsWith(candidate + path.sep)) {
-      typeRoot = candidate
-      break
-    }
-  }
-  const pkgDir = findNearestPackageDir(path.dirname(filePath), typeRoot)
-  if (!pkgDir) {
-    return {
-      runCmd: `bun ${shellQuote(filePath)}`,
-      kind: "bun",
-      execute: { command: "bun", args: [filePath] },
-    }
-  }
-  const installFlag = process.env.AKM_BUN_INSTALL
-  const shouldInstall = installFlag === "1" || installFlag === "true" || installFlag === "yes"
-
-  const quotedPkgDir = shellQuote(pkgDir)
-  const quotedFilePath = shellQuote(filePath)
-  const cdCmd = IS_WINDOWS ? `cd /d ${quotedPkgDir}` : `cd ${quotedPkgDir}`
-  const chain = IS_WINDOWS ? " & " : " && "
-  return {
-    runCmd: shouldInstall
-      ? `${cdCmd}${chain}bun install${chain}bun ${quotedFilePath}`
-      : `${cdCmd}${chain}bun ${quotedFilePath}`,
-    kind: "bun",
-    install: shouldInstall ? { command: "bun", args: ["install"], cwd: pkgDir } : undefined,
-    execute: { command: "bun", args: [filePath], cwd: pkgDir },
-  }
-}
-
-/**
- * Shell-quote a path for inclusion in a human-readable `runCmd` string.
- */
-export function shellQuote(input: string): string {
-  if (/[\r\n\t\0]/.test(input)) {
-    throw new Error("Unsupported control characters in stash path.")
-  }
-  if (IS_WINDOWS) {
-    const escaped = input
-      .replace(/%/g, "%%")
-      .replace(/([\\^|&<>])/g, "^$1")
-      .replace(/"/g, '""')
-    return `"${escaped}"`
-  }
-  const escaped = input
-    .replace(/\\/g, "\\\\")
-    .replace(/"/g, '\\"')
-    .replace(/\$/g, "\\$")
-    .replace(/`/g, "\\`")
-  return `"${escaped}"`
-}
-
-/**
- * Walk up from `startDir` toward `toolsRoot` looking for the nearest `package.json`.
- */
-export function findNearestPackageDir(startDir: string, toolsRoot: string): string | undefined {
-  let current = path.resolve(startDir)
-  const root = path.resolve(toolsRoot)
-  while (isWithin(current, root)) {
-    if (fs.existsSync(path.join(current, "package.json"))) {
-      return current
-    }
-    if (current === root) return undefined
-    current = path.dirname(current)
-  }
-  return undefined
-}
-

package/src/walker.ts

@@ -1,53 +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 fs from "node:fs"
-import path from "node:path"
-import { type AgentikitAssetType } from "./common"
-import { isRelevantAssetFile } from "./asset-spec"
-
-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 function walkStash(typeRoot: string, assetType: AgentikitAssetType): DirectoryGroup[] {
-  if (!fs.existsSync(typeRoot)) return []
-
-  const groups = new Map<string, string[]>()
-
-  const stack = [typeRoot]
-  while (stack.length > 0) {
-    const current = stack.pop()
-    if (!current) continue
-    const entries = fs.readdirSync(current, { withFileTypes: true })
-    for (const entry of entries) {
-      if (entry.name === ".stash.json") continue
-      const fullPath = path.join(current, entry.name)
-      if (entry.isDirectory()) {
-        stack.push(fullPath)
-      } else if (entry.isFile() && isRelevantAssetFile(assetType, entry.name)) {
-        const parentDir = path.dirname(fullPath)
-        const existing = groups.get(parentDir)
-        if (existing) {
-          existing.push(fullPath)
-        } else {
-          groups.set(parentDir, [fullPath])
-        }
-      }
-    }
-  }
-
-  return Array.from(groups, ([dirPath, files]) => ({ dirPath, files }))
-}