A desktop coding agent with free access to frontier models.
TypeScript
import {
RESOURCE_MIME_TYPE,
registerAppResource,
registerAppTool,
} from "./mcp-app-v2.js"
import type { McpUiResourceMeta } from "@modelcontextprotocol/ext-apps"
import type { McpServer } from "@modelcontextprotocol/server"
import { pluginFlowAppHtml } from "@omnirush/mcp-apps/plugin-flow"
import {
pluginFlowAppSchemaVersion,
pluginFlowPayloadSchema,
type PluginFlowPayload,
} from "@omnirush/types/plugin-flow-app"
export { pluginFlowPayloadSchema } from "@omnirush/types/plugin-flow-app"
export const PLUGIN_FLOW_APP_RESOURCE_URI = "ui://omnirush/plugin-flow/v1/view.html"
export const PLUGIN_FLOW_TOOL_NAME = "plugin_flow"
export const PLUGIN_FLOW_APP_HTML = pluginFlowAppHtml
const pluginFlowAppResourceMeta: { ui: McpUiResourceMeta } = {
ui: {
csp: {
connectDomains: [],
resourceDomains: [],
frameDomains: [],
baseUriDomains: [],
},
prefersBorder: true,
},
}
function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === "object" && value !== null && !Array.isArray(value)
}
function stringField(value: unknown): string | null {
return typeof value === "string" && value.trim().length > 0 ? value : null
}
/**
* Library sharing capabilities whose successful execute results render the
* plugin-flow confirmation card. Keys are generated Den catalog operation
* names used by execute_capability.
*/
export function pluginFlowPayloadForCapability(input: {
name: string
path: Record<string, unknown>
body: Record<string, unknown>
}): PluginFlowPayload | null {
if (input.name === "postMarketplacesPlugins") {
return pluginFlowPayloadSchema.parse({
schemaVersion: pluginFlowAppSchemaVersion,
mode: "marketplace_plugin_added",
pluginId: stringField(input.body.pluginId),
marketplaceId: stringField(input.path.marketplaceId),
recipient: null,
})
}
if (input.name === "postPluginsAccess") {
return pluginFlowPayloadSchema.parse({
schemaVersion: pluginFlowAppSchemaVersion,
mode: "plugin_access_granted",
pluginId: stringField(input.path.pluginId),
marketplaceId: null,
recipient: pluginFlowRecipient(input.body),
})
}
if (input.name === "postMarketplacesAccess") {
return pluginFlowPayloadSchema.parse({
schemaVersion: pluginFlowAppSchemaVersion,
mode: "marketplace_access_granted",
pluginId: null,
marketplaceId: stringField(input.path.marketplaceId),
recipient: pluginFlowRecipient(input.body),
})
}
return null
}
function pluginFlowRecipient(body: Record<string, unknown>): PluginFlowPayload["recipient"] {
const role = stringField(body.role)
const orgMembershipId = stringField(body.orgMembershipId)
if (orgMembershipId) return { kind: "member", id: orgMembershipId, role }
const teamId = stringField(body.teamId)
if (teamId) return { kind: "team", id: teamId, role }
if (body.orgWide === true) return { kind: "org_wide", id: null, role }
return null
}
/**
* Attach the plugin-flow card to one successful library-sharing execute
* result: the schema-valid payload becomes the structuredContent the app
* renders, and the same-server `omnirush/mcpApp` launch tells compatible
* hosts to mount the card. The original response JSON stays in content.
*/
export function attachPluginFlowCard<Result extends {
isError?: boolean
structuredContent?: Record<string, unknown>
_meta?: Record<string, unknown>
}>(input: {
name: string
path: unknown
body: unknown
result: Result
}): Result {
if (input.result.isError === true) return input.result
const payload = pluginFlowPayloadForCapability({
name: input.name,
path: isRecord(input.path) ? input.path : {},
body: isRecord(input.body) ? input.body : {},
})
if (!payload) return input.result
return {
...input.result,
structuredContent: { ...payload },
_meta: {
...(input.result._meta ?? {}),
"omnirush/mcpApp": {
toolName: PLUGIN_FLOW_TOOL_NAME,
resourceUri: PLUGIN_FLOW_APP_RESOURCE_URI,
arguments: { mode: payload.mode },
},
},
}
}
export function registerAgentPluginFlowApp(server: McpServer) {
registerAgentPluginFlowResource(server)
registerAppTool(
server,
PLUGIN_FLOW_TOOL_NAME,
{
title: "Plugin flow card",
description: [
"Format one completed library sharing flow (marketplace attach, plugin access grant, marketplace access grant) as a confirmation card.",
"App-only companion to execute_capability results; it backs the plugin-flow card rendered in compatible hosts.",
].join(" "),
annotations: {
readOnlyHint: true,
destructiveHint: false,
idempotentHint: true,
openWorldHint: false,
},
inputSchema: pluginFlowPayloadSchema,
outputSchema: pluginFlowPayloadSchema,
_meta: {
ui: {
resourceUri: PLUGIN_FLOW_APP_RESOURCE_URI,
visibility: ["app"],
},
},
},
async (payload) => ({
content: [{
type: "text" as const,
text: JSON.stringify(payload),
}],
structuredContent: pluginFlowPayloadSchema.parse(payload),
}),
)
}
export function registerAgentPluginFlowResource(server: McpServer) {
registerAppResource(
server,
"OmniRush.ai Plugin Flow",
PLUGIN_FLOW_APP_RESOURCE_URI,
{
description: "A confirmation card for marketplace attach and plugin or marketplace access grants.",
_meta: pluginFlowAppResourceMeta,
},
async () => ({
contents: [{
uri: PLUGIN_FLOW_APP_RESOURCE_URI,
mimeType: RESOURCE_MIME_TYPE,
text: PLUGIN_FLOW_APP_HTML,
_meta: pluginFlowAppResourceMeta,
}],
}),
)
}