archivebox-api 2.5.1__tar.gz → 2.5.2__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.
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/AGENTS.md +14 -2
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/PKG-INFO +2 -2
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/README.md +1 -1
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/connector_manifest.yml +1 -1
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/connectors/tool_schema_fingerprints.json +1 -1
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/kg_ingest.py +6 -6
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/mcp_server.py +2 -2
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api.egg-info/PKG-INFO +2 -2
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api.egg-info/entry_points.txt +3 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/connector_manifest.yml +1 -1
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/pyproject.toml +5 -1
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/release-readiness.json +518 -473
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_web_source.py +21 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/.pre-commit-config.yaml +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/CHANGELOG.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/CLAUDE.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/LICENSE +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/MANIFEST.in +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/__init__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/__main__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/api/__init__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/api/api_client_auth.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/api/api_client_base.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/api/api_client_cli.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/api/api_client_core.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/api_client.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/auth.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/connectors/__init__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/connectors/mcp_source_presets.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/mcp_config.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/__init__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/archivebox.ttl +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/certification.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/fixtures/records.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/mappings/source.yaml +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/migrations/manifest.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/ontology/shapes/connector.shacl.ttl +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/prompts/__init__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/prompts/web_archivist_specialist.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/__init__.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-api-operations/SKILL.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-api-operations/agents/openai.yaml +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-api-operations/references/catalog.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-kg-ingestion/SKILL.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-kg-ingestion/WORKFLOW.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-snapshot-search/SKILL.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-snapshot-search/WORKFLOW.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-web-archiving/SKILL.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/skills/archivebox-web-archiving/WORKFLOW.md +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/web_source.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api/web_source_contract.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api.egg-info/SOURCES.txt +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api.egg-info/dependency_links.txt +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api.egg-info/requires.txt +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/archivebox_api.egg-info/top_level.txt +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/mkdocs.yml +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/opencode.json +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/requirements.txt +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/scripts/security_sanitizer.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/scripts/verify_api_integration.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/setup.cfg +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/conftest.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_action_discovery.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_archivebox_api_brute_force_coverage.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_archivebox_coverage.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_archivebox_coverage_extra.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_basic.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_conformance.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_init_dynamics.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_kg_ingest.py +0 -0
- {archivebox_api-2.5.1 → archivebox_api-2.5.2}/tests/test_kg_media.py +0 -0
|
@@ -1,7 +1,19 @@
|
|
|
1
1
|
# AGENTS.md
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
<!-- agent-contract:start -->
|
|
4
|
+
## Agent contract
|
|
5
|
+
|
|
6
|
+
Tool-neutral rules for any AI agent or human working in this repository. This block is maintained by the fleet standard; edit outside the markers.
|
|
7
|
+
|
|
8
|
+
- **Owner boundary:** this repository owns one external system's calls, mappings and MCP tools (spec prefix `CONN-ARCHIVEBOX-API-`); it depends on the connector SDK only. Feature routing across repositories: [ecosystem boundaries](https://github.com/Knuckles-Team/pipelines/blob/main/reference/ecosystem-boundaries.md).
|
|
9
|
+
- **Setup:** run `scripts/bootstrap.sh`. It is idempotent and non-interactive: it pins uv and Python, syncs the locked environment, installs the git hooks and prints the gate command.
|
|
10
|
+
- **Gates:** `uvx pre-commit run --all-files` must pass before you push. Do not bypass hooks to get green.
|
|
11
|
+
- **Commits:** one logical change per commit with a `Spec: <ID>` trailer (or `Spec: none (<reason>)`), plus a `Co-Authored-By:` trailer naming the assisting agent. Stage explicit paths only; never `git add -A` or `git add .`. Use your own configured Git identity, never a tool or bot name.
|
|
12
|
+
- **Org rules:** [organization AGENTS.md](https://github.com/Knuckles-Team/.github/blob/main/AGENTS.md).
|
|
13
|
+
<!-- agent-contract:end -->
|
|
14
|
+
|
|
15
|
+
> Canonical guidance for any AI coding agent or human; tool-specific entry files
|
|
16
|
+
> (for example `CLAUDE.md`) only import this file. Edit this file.
|
|
5
17
|
|
|
6
18
|
## Tech Stack & Architecture
|
|
7
19
|
- Language/Version: Python 3.10+
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: archivebox-api
|
|
3
|
-
Version: 2.5.
|
|
3
|
+
Version: 2.5.2
|
|
4
4
|
Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
|
|
5
5
|
Author-email: Project Maintainers <maintainers@users.noreply.github.com>
|
|
6
6
|
License: MIT
|
|
@@ -47,7 +47,7 @@ Dynamic: license-file
|
|
|
47
47
|

|
|
48
48
|

|
|
49
49
|
|
|
50
|
-
*Version: 2.5.
|
|
50
|
+
*Version: 2.5.2*
|
|
51
51
|
|
|
52
52
|
> **Documentation** — Installation, deployment, usage across the API, CLI, MCP, and
|
|
53
53
|
> A2A agent interfaces, and guidance for provisioning the ArchiveBox platform are
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|

|
|
21
21
|

|
|
22
22
|
|
|
23
|
-
*Version: 2.5.
|
|
23
|
+
*Version: 2.5.2*
|
|
24
24
|
|
|
25
25
|
> **Documentation** — Installation, deployment, usage across the API, CLI, MCP, and
|
|
26
26
|
> A2A agent interfaces, and guidance for provisioning the ArchiveBox platform are
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"algorithm": "agent-connector-sdk:mcp-tool-contract-compat:v2",
|
|
3
|
-
"connector": "archivebox-
|
|
3
|
+
"connector": "archivebox-mcp",
|
|
4
4
|
"schema_version": "1",
|
|
5
5
|
"tools": {
|
|
6
6
|
"archivebox_get_snapshots": "99b97a41c2cc29078b2cf27af52c6ab99ebc97182eb6100611a86fe3a3abfea4"
|
|
@@ -40,12 +40,12 @@ logger = logging.getLogger("archivebox_api.kg")
|
|
|
40
40
|
_SOURCE = "archivebox-api"
|
|
41
41
|
_DOMAIN = "archivebox"
|
|
42
42
|
|
|
43
|
-
_BINDING = IngestBinding(connector="archivebox-
|
|
43
|
+
_BINDING = IngestBinding(connector="archivebox-mcp", stream=_DOMAIN)
|
|
44
44
|
# sanitize=False: the archived page's own source URL is the product data for a web
|
|
45
45
|
# archive, not incidental PII — the default PersistencePrivacyGuard redacts URL-shaped
|
|
46
46
|
# property values ("[REDACTED_LOCATION]"), which would destroy blob provenance here.
|
|
47
47
|
_BLOB_BINDING = IngestBinding(
|
|
48
|
-
connector="archivebox-
|
|
48
|
+
connector="archivebox-mcp",
|
|
49
49
|
stream=_DOMAIN,
|
|
50
50
|
media_type="AssetOccurrence",
|
|
51
51
|
sanitize=False,
|
|
@@ -66,9 +66,7 @@ def _to_entity(record: dict[str, Any]) -> Entity:
|
|
|
66
66
|
|
|
67
67
|
def _to_relationship(record: dict[str, Any]) -> Relationship:
|
|
68
68
|
props = {
|
|
69
|
-
k: v
|
|
70
|
-
for k, v in record.items()
|
|
71
|
-
if k not in ("source", "target", "relationship")
|
|
69
|
+
k: v for k, v in record.items() if k not in ("source", "target", "relationship")
|
|
72
70
|
}
|
|
73
71
|
return Relationship(
|
|
74
72
|
source=record["source"],
|
|
@@ -331,7 +329,9 @@ async def ingest_snapshots(
|
|
|
331
329
|
if entities
|
|
332
330
|
else None
|
|
333
331
|
)
|
|
334
|
-
doc_res =
|
|
332
|
+
doc_res = (
|
|
333
|
+
await ingest_documents(documents, ingest=ingest) if documents else None
|
|
334
|
+
)
|
|
335
335
|
except IngestUnavailableError as e:
|
|
336
336
|
logger.debug("Operation failed: error_type=%s", type(e).__name__)
|
|
337
337
|
return None
|
|
@@ -41,7 +41,7 @@ from starlette.responses import JSONResponse
|
|
|
41
41
|
from archivebox_api.api_client import Api
|
|
42
42
|
from archivebox_api.auth import get_client
|
|
43
43
|
|
|
44
|
-
__version__ = "2.5.
|
|
44
|
+
__version__ = "2.5.2"
|
|
45
45
|
|
|
46
46
|
# Telemetry & Observability
|
|
47
47
|
logger = get_logger(name="archivebox-api")
|
|
@@ -386,7 +386,7 @@ def get_mcp_instance() -> tuple[Any, ...]:
|
|
|
386
386
|
version=__version__,
|
|
387
387
|
instructions="archivebox-api MCP Server — one typed tool per API operation.",
|
|
388
388
|
content=ConnectorContent(
|
|
389
|
-
connector="archivebox-
|
|
389
|
+
connector="archivebox-mcp",
|
|
390
390
|
package_root=package_root,
|
|
391
391
|
package_version=__version__,
|
|
392
392
|
manifest_path=package_root / "connector_manifest.yml",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: archivebox-api
|
|
3
|
-
Version: 2.5.
|
|
3
|
+
Version: 2.5.2
|
|
4
4
|
Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
|
|
5
5
|
Author-email: Project Maintainers <maintainers@users.noreply.github.com>
|
|
6
6
|
License: MIT
|
|
@@ -47,7 +47,7 @@ Dynamic: license-file
|
|
|
47
47
|

|
|
48
48
|

|
|
49
49
|
|
|
50
|
-
*Version: 2.5.
|
|
50
|
+
*Version: 2.5.2*
|
|
51
51
|
|
|
52
52
|
> **Documentation** — Installation, deployment, usage across the API, CLI, MCP, and
|
|
53
53
|
> A2A agent interfaces, and guidance for provisioning the ArchiveBox platform are
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "archivebox-api"
|
|
7
|
-
version = "2.5.
|
|
7
|
+
version = "2.5.2"
|
|
8
8
|
description = "Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
classifiers = [ "Development Status :: 5 - Production/Stable", "License :: Public Domain", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
|
|
@@ -26,6 +26,10 @@ test = [
|
|
|
26
26
|
[project.scripts]
|
|
27
27
|
archivebox-mcp = "archivebox_api.mcp_server:mcp_server"
|
|
28
28
|
|
|
29
|
+
# The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
|
|
30
|
+
[project.entry-points."agent_connector_sdk.connector"]
|
|
31
|
+
archivebox-mcp = "archivebox_api"
|
|
32
|
+
|
|
29
33
|
[project.entry-points."agent_connector_sdk.skill_providers"]
|
|
30
34
|
archivebox-api = "archivebox_api.skills"
|
|
31
35
|
|