Method install

packages/agent-core/src/plugin/manager.ts:62–140

(source: string)

  }

  async install(source: string): Promise<PluginRecord> {
    const resolved = resolveInstallSource(source);

    let normalizedRoot: string;
    let originalSource: string;
    let sourceType: PluginSource;
    let parsed: ParsedManifestResult;
    let id: string;
    let github: PluginGithubMetadata | undefined;

    if (resolved.kind === 'local-path') {
      const sourceRoot = await normalizeInstallRoot(resolved.path);
      originalSource = resolved.path;
      sourceType = 'local-path';
      parsed = await parseManifest(sourceRoot);
      if (parsed.manifest === undefined) {
        const msg = parsed.diagnostics.find((d) => d.severity === 'error')?.message ?? 'no manifest';
        throw new Error(`Cannot install plugin at ${sourceRoot}: ${msg}`);
      }
      id = normalizePluginId(parsed.manifest.name);
      normalizedRoot = await copyPluginToManagedRoot(this.kimiHomeDir, id, sourceRoot);
      parsed = await parseManifest(normalizedRoot);
    } else {
      let zipUrl: string;
      if (resolved.kind === 'github') {
        const githubResolution = await resolveGithubSource(resolved);
        zipUrl = githubResolution.tarballUrl;
        originalSource = source.trim();
        sourceType = 'github';
        github = {
          owner: resolved.owner,
          repo: resolved.repo,
          ref: githubResolution.ref,
        };
      } else {
        zipUrl = resolved.path;
        originalSource = resolved.path;
        sourceType = 'zip-url';
      }
      const buffer = await downloadZip(zipUrl);
      const tmpDir = await mkdtemp(path.join(tmpdir(), 'kimi-plugin-zip-'));
      try {
        const detectedRoot = await extractZip(buffer, tmpDir);
        parsed = await parseManifest(detectedRoot);
        if (parsed.manifest === undefined) {
          const msg = parsed.diagnostics.find((d) => d.severity === 'error')?.message ?? 'no manifest';
          throw new Error(`Cannot install plugin from ${originalSource}: ${msg}`);
        }
        id = normalizePluginId(parsed.manifest.name);
        normalizedRoot = await copyPluginToManagedRoot(this.kimiHomeDir, id, detectedRoot);
        parsed = await parseManifest(normalizedRoot);
      } finally {
        await rm(tmpDir, { recursive: true, force: true });
      }
    }

    if (parsed.manifest === undefined) {
      const msg = parsed.diagnostics.find((d) => d.severity === 'error')?.message ?? 'no manifest';