@homeflare/alchemy 0.52.0 → 0.53.1

package/src/litellm/marketplace-types.ts

@@ -0,0 +1,53 @@
+/**
+ * What a `LiteLLM.ClaudeCodeMarketplacePlugin` declares (props) and remembers (attributes).
+ *
+ * ★ A PLUGIN IS A MARKETPLACE ENTRY, NOT A SKILL. LiteLLM serves `/claude-code/marketplace.json`
+ *   from the plugins registered under `/claude-code/plugins`; Claude Code installs from that
+ *   marketplace. The plugin folders a seat loads stay what they are (Tim, 2026-10-01); this entry
+ *   points the marketplace at the same folder through `source`.
+ * ★ THE NAME IS THE IDENTITY. `name` is the path key of every read, update and delete, so it cannot
+ *   be renamed in place: changing `pluginName` is a replace, never an update.
+ * ⚠️ `enabled` DEFAULTS TO `true`. A registered but disabled plugin is absent from the marketplace
+ *   file, so a declaration that means "listed" must also mean "enabled".
+ */
+export interface PluginAuthor {
+  readonly name: string;
+  readonly email?: string;
+}
+
+export interface MarketplacePluginProps {
+  /** kebab-case plugin name, e.g. `homeflare-workflows`. Also the way an existing row is adopted. */
+  readonly pluginName: string;
+  /**
+   * Where Claude Code fetches the plugin from, as LiteLLM takes it: `{ source: 'github', repo }`,
+   * `{ source: 'url', url }`, `{ source: 'git-subdir', url, path }` or `{ source: 'archive', url, sha256? }`.
+   * Always compared.
+   */
+  readonly source: Readonly<Record<string, string>>;
+  /** Compared only when declared: adopting never clears text a person wrote. */
+  readonly description?: string;
+  readonly version?: string;
+  readonly domain?: string;
+  readonly namespace?: string;
+  readonly category?: string;
+  readonly homepage?: string;
+  readonly keywords?: readonly string[];
+  readonly author?: PluginAuthor;
+  /** Whether the marketplace lists it. Default `true`. */
+  readonly enabled?: boolean;
+}
+
+export interface MarketplacePluginAttributes {
+  readonly pluginId: string;
+  readonly pluginName: string;
+  readonly source: Readonly<Record<string, string>>;
+  readonly enabled: boolean;
+  readonly description: string | null;
+  readonly version: string | null;
+  readonly domain: string | null;
+  readonly namespace: string | null;
+  readonly category: string | null;
+  readonly homepage: string | null;
+  readonly keywords: readonly string[];
+  readonly author: { readonly name: string; readonly email: string | null } | null;
+}

package/src/litellm/providers.ts

@@ -22,6 +22,7 @@ import { type Credentials, CredentialsFromEnv } from '@distilled.cloud/litellm/C
 import * as Layer from 'effect/Layer';
 import { LiteLLMAccessGroupProvider } from './access-group.ts';
 import { LiteLLMBudgetProvider } from './budget.ts';
+import { LiteLLMClaudeCodeMarketplacePluginProvider } from './marketplace-plugin.ts';
 import { LiteLLMCredentialProvider } from './credential.ts';
 import { LiteLLMMCPServerProvider } from './mcp-server.ts';
 import { LiteLLMKeyProvider } from './key.ts';
@@ -40,6 +41,7 @@ export const litellmProviders = (creds: Layer.Layer<Credentials> = CredentialsFr
     LiteLLMCredentialProvider(),
     LiteLLMMCPServerProvider(),
     LiteLLMAccessGroupProvider(),
+    LiteLLMClaudeCodeMarketplacePluginProvider(),
     LiteLLMToolsetProvider(),
     LiteLLMToolPolicyProvider(),
     LiteLLMPolicyProvider(),

package/src/litellm/registry-exports.test.ts

@@ -14,6 +14,12 @@ const RESOURCES = [
     'LiteLLM.AccessGroup',
     'LiteLLMAccessGroupProvider',
   ],
+  [
+    'LiteLLMClaudeCodeMarketplacePlugin',
+    'isLiteLLMClaudeCodeMarketplacePlugin',
+    'LiteLLM.ClaudeCodeMarketplacePlugin',
+    'LiteLLMClaudeCodeMarketplacePluginProvider',
+  ],
   ['LiteLLMToolset', 'isLiteLLMToolset', 'LiteLLM.Toolset', 'LiteLLMToolsetProvider'],
   ['LiteLLMPolicy', 'isLiteLLMPolicy', 'LiteLLM.Policy', 'LiteLLMPolicyProvider'],
   [