ctx.getExtension stable

Consume another extension's published API — the mechanism that lets features live outside core (git, terminal, themes) yet expose capabilities to other extensions. This is how "first-party = third-party" works in practice.

ctx.getExtension<API>(id: string): ExtensionHandle<API> | undefined

Example

// consume the git extension's API, tolerating its absence
const git = ctx.getExtension<GitAPI>("silo.git");
if (git?.active && git.api) {
  const status = await git.api.status(cwd);
}

Returns undefined if no extension with that id is known. Even when known, its api is undefined until that extension has activated — so always handle absence: the provider may be disabled or activate after you. Call getExtension at use time, not inside your own activate.

Publishing an API

The other side of the mechanism: return an object from your activate and it becomes your published API.

export const extension: Extension<GitAPI> = {
  id: "silo.git",
  activate(ctx): GitAPI {
    return { status: (cwd) => /* … */ };
  },
};

Ship your API's types as a package (e.g. @silo-code/git-api) so consumers get type-safe access.

Types

ExtensionHandle · Extension (its activate return is the API).