Function PlannotatorPlugin

apps/opencode-plugin/index.ts:280–709

(ctx, rawOptions?: PlannotatorOpenCodeOptions)

}

const PlannotatorPlugin: Plugin = async (ctx, rawOptions?: PlannotatorOpenCodeOptions) => {
  const workflowOptions = normalizeWorkflowOptions(rawOptions);

  // Preload HTML in background — populates the sync cache before first use
  readFile(resolveBundledHtmlPath("plannotator.html"), "utf-8").then(h => { _planHtml = h; }).catch(() => {});
  readFile(resolveBundledHtmlPath("review-editor.html"), "utf-8").then(h => { _reviewHtml = h; }).catch(() => {});

  let cachedAgents: any[] | null = null;

  async function getSharingEnabled(): Promise<boolean> {
    try {
      const response = await ctx.client.config.get({ query: { directory: ctx.directory } });
      // @ts-ignore - share config may exist
      const share = response?.data?.share;
      if (share !== undefined) {
        return share !== "disabled";
      }
    } catch {
      // Config read failed, fall through to env var / plannotator config
    }
    return resolveSharingEnabled(loadConfig());
  }

  function getShareBaseUrl(): string | undefined {
    return process.env.PLANNOTATOR_SHARE_URL || undefined;
  }

  function getPasteApiUrl(): string | undefined {
    return process.env.PLANNOTATOR_PASTE_URL || undefined;
  }

  async function getOpenCodeAgents(): Promise<any[] | undefined> {
    try {
      if (!cachedAgents) {
        const response = await ctx.client.app.agents({
          query: { directory: ctx.directory },
        });
        cachedAgents = response.data ?? [];
      }
      return cachedAgents;
    } catch {
      return undefined;
    }
  }

  async function getBridgeContext(): Promise<OpenCodeBridgeContext> {
    return {
      sharingEnabled: await getSharingEnabled(),
      shareBaseUrl: getShareBaseUrl(),
      pasteApiUrl: getPasteApiUrl(),
      agents: await getOpenCodeAgents(),
    };
  }

  function getPlanTimeoutSeconds(): number | null {
    const raw = process.env.PLANNOTATOR_PLAN_TIMEOUT_SECONDS?.trim();
    if (!raw) return DEFAULT_PLAN_TIMEOUT_SECONDS;