File size: 4,169 Bytes
4c76b0d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
// Embedding provider contract tests cover plugin embedding provider SDK behavior.
import * as embeddingProviderSdk from "openclaw/plugin-sdk/embedding-providers";
import {
  createPluginRegistryFixture,
  registerVirtualTestPlugin,
} from "openclaw/plugin-sdk/plugin-test-contracts";
import { describe, expect, it } from "vitest";

describe("embedding provider registration", () => {
  it("keeps public SDK helpers read-only so plugins cannot bypass manifest ownership", () => {
    expect(embeddingProviderSdk).not.toHaveProperty("registerEmbeddingProvider");
    expect(embeddingProviderSdk).not.toHaveProperty("listRegisteredEmbeddingProviders");
    expect(embeddingProviderSdk).not.toHaveProperty("clearEmbeddingProviders");
    expect(embeddingProviderSdk).not.toHaveProperty("restoreEmbeddingProviders");
    expect(embeddingProviderSdk).not.toHaveProperty("restoreRegisteredEmbeddingProviders");
  });

  it("rejects plugins that did not declare the capability contract", () => {
    const { config, registry } = createPluginRegistryFixture();

    registerVirtualTestPlugin({
      registry,
      config,
      id: "not-embedding",
      name: "Not Embedding",
      register(api) {
        api.registerEmbeddingProvider({
          id: "forbidden",
          create: async () => ({ provider: null }),
        });
      },
    });
    expect(registry.registry.embeddingProviders).toStrictEqual([]);
    const diagnostic = registry.registry.diagnostics.find(
      (entry) => entry.pluginId === "not-embedding",
    );
    expect(diagnostic?.message).toBe(
      "plugin must declare contracts.embeddingProviders for adapter: forbidden",
    );
  });

  it("allows plugins that declare the capability contract", () => {
    const { config, registry } = createPluginRegistryFixture();

    registerVirtualTestPlugin({
      registry,
      config,
      id: "embedding-owner",
      name: "Embedding Owner",
      contracts: {
        embeddingProviders: ["embedding-owner"],
      },
      register(api) {
        api.registerEmbeddingProvider({
          id: "embedding-owner",
          create: async () => ({ provider: null }),
        });
      },
    });
    const provider = registry.registry.embeddingProviders[0];
    expect(provider?.provider.id).toBe("embedding-owner");
    expect(provider?.pluginId).toBe("embedding-owner");
    expect(registry.registry.embeddingProviders).toHaveLength(1);
    expect(registry.registry.plugins[0]?.embeddingProviderIds).toContain("embedding-owner");
  });

  it("rejects duplicate provider ids", () => {
    const { config, registry } = createPluginRegistryFixture();

    for (const id of ["first-owner", "second-owner"]) {
      registerVirtualTestPlugin({
        registry,
        config,
        id,
        name: id,
        contracts: {
          embeddingProviders: ["shared"],
        },
        register(api) {
          api.registerEmbeddingProvider({
            id: "shared",
            create: async () => ({ provider: null }),
          });
        },
      });
    }

    expect(registry.registry.embeddingProviders).toHaveLength(1);
    const diagnostic = registry.registry.diagnostics.find(
      (entry) => entry.pluginId === "second-owner",
    );
    expect(diagnostic?.message).toBe(
      "embedding provider already registered: shared (owner: first-owner)",
    );
  });

  it("keeps core embedding provider ids reserved", () => {
    const { config, registry } = createPluginRegistryFixture();

    registerVirtualTestPlugin({
      registry,
      config,
      id: "core-shadow",
      name: "Core Shadow",
      contracts: {
        embeddingProviders: ["openai-compatible"],
      },
      register(api) {
        api.registerEmbeddingProvider({
          id: "openai-compatible",
          create: async () => ({ provider: null }),
        });
      },
    });

    expect(registry.registry.embeddingProviders).toStrictEqual([]);
    const diagnostic = registry.registry.diagnostics.find(
      (entry) => entry.pluginId === "core-shadow",
    );
    expect(diagnostic?.message).toBe(
      "embedding provider already registered: openai-compatible (owner: core)",
    );
  });
});