semantic-kernel-surface 0.1.0__tar.gz → 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,84 @@
1
+ Metadata-Version: 2.5
2
+ Name: semantic-kernel-surface
3
+ Version: 0.1.1
4
+ Summary: Surface for Semantic Kernel: the link-safety layer between an AI agent and the open web. One tool, surface_preflight, that tells your agent whether a link is worth fetching.
5
+ Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
6
+ Project-URL: Documentation, https://nova-otter-delta-cloud.grok.me/docs
7
+ Project-URL: API reference, https://nova-otter-delta-cloud.grok.me/llms.txt
8
+ Project-URL: MCP server, https://nova-otter-delta-cloud.grok.me/mcp
9
+ Author-email: Canada Site Ops <canada.site.ops@gmail.com>
10
+ Maintainer-email: Canada Site Ops <canada.site.ops@gmail.com>
11
+ License: MIT
12
+ License-File: LICENSE
13
+ Keywords: ai-agents,kernel-function,link-safety,mcp,preflight,semantic-kernel,sk-plugin,surface,tools,url
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Topic :: Internet :: WWW/HTTP
17
+ Requires-Python: >=3.10
18
+ Requires-Dist: semantic-kernel>=1.0
19
+ Description-Content-Type: text/markdown
20
+
21
+ # semantic-kernel-surface
22
+
23
+ Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. A hop or a 1×1 pixel counts the same way, with no install. Free for the first million requests a month. https://nova-otter-delta-cloud.grok.me
24
+
25
+ This package gives Semantic Kernel agents that check as one ready-made tool: `SurfacePlugin`.
26
+
27
+ Surface by Canada Site Ops. Ontario, Canada.
28
+
29
+ ## Get a free API key in about 10 seconds
30
+
31
+ No email, no card. Then set `SURFACE_API_KEY`. The tool sends it as `Authorization: Bearer <key>`.
32
+
33
+ ```bash
34
+ curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
35
+ # returns {"key","created_at","free_monthly":1000000,"usage_url"}
36
+ export SURFACE_API_KEY=... # paste the key value
37
+ ```
38
+
39
+ A key gets its own million free requests a month. The tool also runs without a key on a shared demo limit.
40
+
41
+ ## Install
42
+
43
+ ```bash
44
+ pip install semantic-kernel-surface
45
+ ```
46
+
47
+ ```python
48
+ from semantic_kernel import Kernel
49
+ from semantic_kernel_surface import SurfacePlugin
50
+
51
+ kernel = Kernel()
52
+ kernel.add_plugin(SurfacePlugin(), plugin_name="surface")
53
+ ```
54
+
55
+ The tool returns `next: fetch` or `next: skip`, plus where the link really goes (unwraps t.co, bit.ly, lnkd.in, youtu.be). It never downloads the page. On any error it answers `skip`.
56
+
57
+ ## Prefer MCP?
58
+
59
+ Mint a key first, then paste this into your MCP settings (tool `preflight_url`):
60
+
61
+ ```json
62
+ {
63
+ "mcpServers": {
64
+ "surface": {
65
+ "type": "http",
66
+ "url": "https://nova-otter-delta-cloud.grok.me/mcp",
67
+ "headers": {
68
+ "Authorization": "Bearer REPLACE_WITH_YOUR_KEY"
69
+ }
70
+ }
71
+ }
72
+ }
73
+ ```
74
+
75
+ ## Also listed
76
+
77
+ - Official MCP Registry: `me.grok.nova-otter-delta-cloud/surface`
78
+ - https://www.curatedmcp.com/marketplace/surface
79
+ - https://www.npmjs.com/package/@surfaceapi/surface
80
+ - https://pypi.org/project/semantic-kernel-surface/
81
+ - https://pypi.org/project/surfaceapi/
82
+ - https://huggingface.co/spaces/surfaceapi/surface-preflight
83
+
84
+ CLI and GitHub Action are coming soon.
@@ -0,0 +1,64 @@
1
+ # semantic-kernel-surface
2
+
3
+ Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. A hop or a 1×1 pixel counts the same way, with no install. Free for the first million requests a month. https://nova-otter-delta-cloud.grok.me
4
+
5
+ This package gives Semantic Kernel agents that check as one ready-made tool: `SurfacePlugin`.
6
+
7
+ Surface by Canada Site Ops. Ontario, Canada.
8
+
9
+ ## Get a free API key in about 10 seconds
10
+
11
+ No email, no card. Then set `SURFACE_API_KEY`. The tool sends it as `Authorization: Bearer <key>`.
12
+
13
+ ```bash
14
+ curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
15
+ # returns {"key","created_at","free_monthly":1000000,"usage_url"}
16
+ export SURFACE_API_KEY=... # paste the key value
17
+ ```
18
+
19
+ A key gets its own million free requests a month. The tool also runs without a key on a shared demo limit.
20
+
21
+ ## Install
22
+
23
+ ```bash
24
+ pip install semantic-kernel-surface
25
+ ```
26
+
27
+ ```python
28
+ from semantic_kernel import Kernel
29
+ from semantic_kernel_surface import SurfacePlugin
30
+
31
+ kernel = Kernel()
32
+ kernel.add_plugin(SurfacePlugin(), plugin_name="surface")
33
+ ```
34
+
35
+ The tool returns `next: fetch` or `next: skip`, plus where the link really goes (unwraps t.co, bit.ly, lnkd.in, youtu.be). It never downloads the page. On any error it answers `skip`.
36
+
37
+ ## Prefer MCP?
38
+
39
+ Mint a key first, then paste this into your MCP settings (tool `preflight_url`):
40
+
41
+ ```json
42
+ {
43
+ "mcpServers": {
44
+ "surface": {
45
+ "type": "http",
46
+ "url": "https://nova-otter-delta-cloud.grok.me/mcp",
47
+ "headers": {
48
+ "Authorization": "Bearer REPLACE_WITH_YOUR_KEY"
49
+ }
50
+ }
51
+ }
52
+ }
53
+ ```
54
+
55
+ ## Also listed
56
+
57
+ - Official MCP Registry: `me.grok.nova-otter-delta-cloud/surface`
58
+ - https://www.curatedmcp.com/marketplace/surface
59
+ - https://www.npmjs.com/package/@surfaceapi/surface
60
+ - https://pypi.org/project/semantic-kernel-surface/
61
+ - https://pypi.org/project/surfaceapi/
62
+ - https://huggingface.co/spaces/surfaceapi/surface-preflight
63
+
64
+ CLI and GitHub Action are coming soon.
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "semantic-kernel-surface"
7
- version = "0.1.0"
7
+ version = "0.1.1"
8
8
  description = "Surface for Semantic Kernel: the link-safety layer between an AI agent and the open web. One tool, surface_preflight, that tells your agent whether a link is worth fetching."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -16,7 +16,7 @@ dependencies = ["semantic-kernel>=1.0"]
16
16
  classifiers = ["Programming Language :: Python :: 3","License :: OSI Approved :: MIT License","Topic :: Internet :: WWW/HTTP"]
17
17
 
18
18
  [project.urls]
19
- Homepage = "https://otter-sand-wolf-spring.grok.me"
19
+ Homepage = "https://nova-otter-delta-cloud.grok.me"
20
20
  Documentation = "https://nova-otter-delta-cloud.grok.me/docs"
21
21
  "API reference" = "https://nova-otter-delta-cloud.grok.me/llms.txt"
22
22
  "MCP server" = "https://nova-otter-delta-cloud.grok.me/mcp"
@@ -7,6 +7,6 @@ class SurfacePlugin:
7
7
  """Semantic Kernel plugin: the link-safety layer between an AI agent and the open web."""
8
8
  @kernel_function(name="surface_preflight", description=TOOL_DESCRIPTION)
9
9
  def surface_preflight(self, url: Annotated[str, "The link to check"]) -> Annotated[str, "JSON verdict: fetch or skip"]:
10
- return preflight_text(url, ua="semantic-kernel-surface/0.1.0")
10
+ return preflight_text(url, ua="semantic-kernel-surface/0.1.1")
11
11
 
12
12
  __all__ = [n for n in dir() if not n.startswith("__")]
@@ -13,7 +13,7 @@ TOOL_DESCRIPTION = (
13
13
  )
14
14
 
15
15
  def preflight(url: str, api_key: Optional[str] = None, base_url: Optional[str] = None,
16
- timeout: float = 15.0, headers: Optional[Dict[str, str]] = None, ua: str = "surface-python/0.1.0") -> Dict[str, Any]:
16
+ timeout: float = 15.0, headers: Optional[Dict[str, str]] = None, ua: str = "surface-python/0.1.1") -> Dict[str, Any]:
17
17
  """Call Surface Preflight and return a compact verdict dict."""
18
18
  base = (base_url or os.environ.get("SURFACE_BASE_URL") or DEFAULT_BASE_URL).rstrip("/")
19
19
  key = api_key or os.environ.get("SURFACE_API_KEY")
@@ -1,58 +0,0 @@
1
- Metadata-Version: 2.5
2
- Name: semantic-kernel-surface
3
- Version: 0.1.0
4
- Summary: Surface for Semantic Kernel: the link-safety layer between an AI agent and the open web. One tool, surface_preflight, that tells your agent whether a link is worth fetching.
5
- Project-URL: Homepage, https://otter-sand-wolf-spring.grok.me
6
- Project-URL: Documentation, https://nova-otter-delta-cloud.grok.me/docs
7
- Project-URL: API reference, https://nova-otter-delta-cloud.grok.me/llms.txt
8
- Project-URL: MCP server, https://nova-otter-delta-cloud.grok.me/mcp
9
- Author-email: Canada Site Ops <canada.site.ops@gmail.com>
10
- Maintainer-email: Canada Site Ops <canada.site.ops@gmail.com>
11
- License: MIT
12
- License-File: LICENSE
13
- Keywords: ai-agents,kernel-function,link-safety,mcp,preflight,semantic-kernel,sk-plugin,surface,tools,url
14
- Classifier: License :: OSI Approved :: MIT License
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Topic :: Internet :: WWW/HTTP
17
- Requires-Python: >=3.10
18
- Requires-Dist: semantic-kernel>=1.0
19
- Description-Content-Type: text/markdown
20
-
21
- # semantic-kernel-surface
22
-
23
- **Surface is the link-safety layer between an AI agent and the open web.** Before your agent opens a link someone pasted, Surface checks it: it unwraps short links (t.co, bit.ly, lnkd.in, youtu.be), follows the redirects, and answers **fetch** or **skip**, along with where the link really goes. It never downloads the page for you, so it's fast and cheap. If Surface can't be reached, the tool answers skip, so your agent stays safe.
24
-
25
- This package gives Semantic Kernel agents that check as one ready-made tool: `surface_preflight`.
26
-
27
- ```bash
28
- pip install semantic-kernel-surface
29
- ```
30
-
31
- ```python
32
- from semantic_kernel import Kernel
33
- from semantic_kernel_surface import SurfacePlugin
34
-
35
- kernel = Kernel()
36
- kernel.add_plugin(SurfacePlugin(), plugin_name="surface")
37
- ```
38
-
39
- ## Free to start
40
-
41
- The first 1M requests a month are free. It works with no key at all (shared demo limit), or grab your own free key in one call, with no email and no card:
42
-
43
- ```bash
44
- curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
45
- export SURFACE_API_KEY=...
46
- ```
47
-
48
- After the free tier: $0.25 USD per 1,000 preflights.
49
-
50
- ## Prefer MCP?
51
-
52
- Point any MCP client at `https://nova-otter-delta-cloud.grok.me/mcp` (tool `preflight_url`).
53
-
54
- - Website: https://otter-sand-wolf-spring.grok.me
55
- - Docs: https://nova-otter-delta-cloud.grok.me/docs
56
- - LLM reference: https://nova-otter-delta-cloud.grok.me/llms.txt
57
-
58
- Made by Canada Site Ops. MIT licensed.
@@ -1,38 +0,0 @@
1
- # semantic-kernel-surface
2
-
3
- **Surface is the link-safety layer between an AI agent and the open web.** Before your agent opens a link someone pasted, Surface checks it: it unwraps short links (t.co, bit.ly, lnkd.in, youtu.be), follows the redirects, and answers **fetch** or **skip**, along with where the link really goes. It never downloads the page for you, so it's fast and cheap. If Surface can't be reached, the tool answers skip, so your agent stays safe.
4
-
5
- This package gives Semantic Kernel agents that check as one ready-made tool: `surface_preflight`.
6
-
7
- ```bash
8
- pip install semantic-kernel-surface
9
- ```
10
-
11
- ```python
12
- from semantic_kernel import Kernel
13
- from semantic_kernel_surface import SurfacePlugin
14
-
15
- kernel = Kernel()
16
- kernel.add_plugin(SurfacePlugin(), plugin_name="surface")
17
- ```
18
-
19
- ## Free to start
20
-
21
- The first 1M requests a month are free. It works with no key at all (shared demo limit), or grab your own free key in one call, with no email and no card:
22
-
23
- ```bash
24
- curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
25
- export SURFACE_API_KEY=...
26
- ```
27
-
28
- After the free tier: $0.25 USD per 1,000 preflights.
29
-
30
- ## Prefer MCP?
31
-
32
- Point any MCP client at `https://nova-otter-delta-cloud.grok.me/mcp` (tool `preflight_url`).
33
-
34
- - Website: https://otter-sand-wolf-spring.grok.me
35
- - Docs: https://nova-otter-delta-cloud.grok.me/docs
36
- - LLM reference: https://nova-otter-delta-cloud.grok.me/llms.txt
37
-
38
- Made by Canada Site Ops. MIT licensed.