Skip to content

feat: Add remote plugin fields to plugin API#17277

Merged
xl-openai merged 1 commit intomainfrom
xl/plugins3
Apr 17, 2026
Merged

feat: Add remote plugin fields to plugin API#17277
xl-openai merged 1 commit intomainfrom
xl/plugins3

Conversation

@xl-openai
Copy link
Copy Markdown
Collaborator

Summary

Update the plugin API for the new remote plugin model.

The mental model is no longer “keep local plugin state in sync with remote.” Instead, local and remote plugins are becoming separate sources. Remote catalog entries can be shown directly from the remote API before installation; after installation they are still downloaded into the local cache for execution, but remote installed state will come from the API and be held in memory rather than being read from config.

• ## API changes

  • Remove forceRemoteSync from plugin/list, plugin/install, and plugin/uninstall.
  • Remove remoteSyncError from plugin/list.
  • Add remote-capable metadata to plugin/list / plugin/read:
    • nullable marketplaces[].path
    • source: { type: "remote", downloadUrl }
    • URL asset fields alongside local path fields:
      composerIconUrl, logoUrl, screenshotUrls
  • Make plugin/read and plugin/install source-compatible:
    • marketplacePath?: AbsolutePathBuf | null
    • remoteMarketplaceName?: string | null
    • exactly one source is required at runtime

@xl-openai xl-openai changed the title feat: Add remote plugin catalog fields to plugin API feat: Add remote plugin fields to plugin API Apr 10, 2026
Copy link
Copy Markdown
Contributor

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4b9256c2c1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

} else {
plugins_manager.install_plugin(request).await
};
let install_result = plugins_manager.install_plugin(request).await;
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Preserve remote-state mutation in plugin/install

plugin/install now always calls plugins_manager.install_plugin(...), which performs only local install/config writes. The remote enable call path (install_plugin_with_remote_sync) is no longer reachable, so remote installed-state can drift from local state. Because removed forceRemoteSync is silently ignored at deserialization, legacy callers get a success response but no backend mutation.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

forceRemoteSync is never used in prod

} else {
plugins_manager.uninstall_plugin(plugin_id).await
};
let uninstall_result = plugins_manager.uninstall_plugin(plugin_id).await;
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Preserve remote-state mutation in plugin/uninstall

plugin/uninstall now unconditionally uses plugins_manager.uninstall_plugin(...), which only removes local cache/config. The remote uninstall path (uninstall_plugin_with_remote_sync) is no longer invoked, so backend installed-state can remain stale after local uninstall. This creates inconsistent plugin state once remote state is used as source of truth.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

forceRemoteSync is never actually used in prod

@xl-openai xl-openai force-pushed the xl/plugins3 branch 2 times, most recently from 1ca420d to 0e2524d Compare April 10, 2026 01:54
Copy link
Copy Markdown
Collaborator

@sayan-oai sayan-oai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

codex says some plugin/* descriptions in the app-server readme are out of date.

lgtm otherwise

@xl-openai
Copy link
Copy Markdown
Collaborator Author

Intentionally leave README.md outdated a little bit as the new feature is not ready to use yet.

@xl-openai xl-openai merged commit 26d9894 into main Apr 17, 2026
34 of 36 checks passed
@xl-openai xl-openai deleted the xl/plugins3 branch April 17, 2026 23:48
@github-actions github-actions Bot locked and limited conversation to collaborators Apr 17, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants