archivebox-api 2.5.5__tar.gz → 2.5.7__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.
Files changed (77) hide show
  1. archivebox_api-2.5.7/.pre-commit-config.yaml +32 -0
  2. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/AGENTS.md +1 -1
  3. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/CHANGELOG.md +10 -0
  4. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/PKG-INFO +3 -9
  5. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/README.md +0 -2
  6. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/__init__.py +13 -0
  7. archivebox_api-2.5.7/archivebox_api/__main__.py +4 -0
  8. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/connector_sources.py +16 -41
  9. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/kg_ingest.py +2 -1
  10. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/mcp_server.py +0 -67
  11. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/certification.json +5 -5
  12. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/mappings/source.yaml +1 -1
  13. archivebox_api-2.5.7/archivebox_api/skills/archivebox-api-development/SKILL.md +109 -0
  14. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api.egg-info/PKG-INFO +3 -9
  15. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api.egg-info/SOURCES.txt +2 -7
  16. archivebox_api-2.5.7/archivebox_api.egg-info/entry_points.txt +8 -0
  17. archivebox_api-2.5.7/archivebox_api.egg-info/requires.txt +7 -0
  18. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api.egg-info/top_level.txt +0 -1
  19. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/pyproject.toml +16 -14
  20. archivebox_api-2.5.7/release-readiness.json +5971 -0
  21. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_archivebox_api_brute_force_coverage.py +0 -21
  22. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_archivebox_coverage.py +0 -73
  23. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_archivebox_coverage_extra.py +0 -104
  24. archivebox_api-2.5.7/tests/test_archivebox_development_skill.py +41 -0
  25. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_conformance.py +2 -1
  26. archivebox_api-2.5.5/.pre-commit-config.yaml +0 -158
  27. archivebox_api-2.5.5/archivebox_api/__main__.py +0 -4
  28. archivebox_api-2.5.5/archivebox_api/connectors/__init__.py +0 -0
  29. archivebox_api-2.5.5/archivebox_api/prompts/__init__.py +0 -0
  30. archivebox_api-2.5.5/archivebox_api/skills/__init__.py +0 -0
  31. archivebox_api-2.5.5/archivebox_api.egg-info/entry_points.txt +0 -14
  32. archivebox_api-2.5.5/archivebox_api.egg-info/requires.txt +0 -13
  33. archivebox_api-2.5.5/opencode.json +0 -18
  34. archivebox_api-2.5.5/release-readiness.json +0 -16198
  35. archivebox_api-2.5.5/scripts/security_sanitizer.py +0 -318
  36. archivebox_api-2.5.5/scripts/verify_api_integration.py +0 -320
  37. archivebox_api-2.5.5/tests/test_default_content_surfaces.py +0 -43
  38. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/CLAUDE.md +0 -0
  39. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/LICENSE +0 -0
  40. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/MANIFEST.in +0 -0
  41. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/api/__init__.py +0 -0
  42. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/api/api_client_auth.py +0 -0
  43. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/api/api_client_base.py +0 -0
  44. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/api/api_client_cli.py +0 -0
  45. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/api/api_client_core.py +0 -0
  46. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/api_client.py +0 -0
  47. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/auth.py +0 -0
  48. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/mcp_config.json +0 -0
  49. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/__init__.py +0 -0
  50. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/archivebox.ttl +0 -0
  51. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/fixtures/records.json +0 -0
  52. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/migrations/manifest.json +0 -0
  53. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/ontology/shapes/connector.shacl.ttl +0 -0
  54. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/prompts/web_archivist_specialist.json +0 -0
  55. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/SKILL.md +0 -0
  56. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/agents/openai.yaml +0 -0
  57. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/references/catalog.md +0 -0
  58. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-kg-ingestion/SKILL.md +0 -0
  59. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-kg-ingestion/WORKFLOW.md +0 -0
  60. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-snapshot-search/SKILL.md +0 -0
  61. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-snapshot-search/WORKFLOW.md +0 -0
  62. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-web-archiving/SKILL.md +0 -0
  63. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-web-archiving/WORKFLOW.md +0 -0
  64. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/web_source.py +0 -0
  65. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api/web_source_contract.py +0 -0
  66. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/archivebox_api.egg-info/dependency_links.txt +0 -0
  67. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/mkdocs.yml +0 -0
  68. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/requirements.txt +0 -0
  69. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/setup.cfg +0 -0
  70. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/conftest.py +0 -0
  71. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_action_discovery.py +0 -0
  72. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_basic.py +0 -0
  73. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_init_dynamics.py +0 -0
  74. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_kg_ingest.py +0 -0
  75. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_kg_media.py +0 -0
  76. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_sdk_transport.py +0 -0
  77. {archivebox_api-2.5.5 → archivebox_api-2.5.7}/tests/test_web_source.py +0 -0
@@ -0,0 +1,32 @@
1
+ # The whole pre-commit configuration of a connector (PIPE-VALIDATION-R001.9). Everything a
2
+ # connector used to copy lives in pipelines at `rev: main`: the sanitizer, the standard-file
3
+ # check, the codespell defaults and the gate set. A change to a shared check reaches every
4
+ # connector with no edit here. Per-repo options go in pyproject.toml tables only.
5
+ default_install_hook_types: [pre-commit, pre-push]
6
+ default_stages: [pre-commit]
7
+ repos:
8
+ - repo: https://github.com/pre-commit/pre-commit-hooks
9
+ rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c # v6.0.0
10
+ hooks:
11
+ - id: trailing-whitespace
12
+ - id: end-of-file-fixer
13
+ - id: check-merge-conflict
14
+ - id: check-yaml
15
+ args: [--unsafe]
16
+ - id: check-toml
17
+ - id: check-json
18
+ - id: detect-private-key
19
+ - repo: https://github.com/astral-sh/ruff-pre-commit
20
+ rev: cb8c523fd4835aba42af70f4cad5568db4df0b6c # v0.16.0
21
+ hooks:
22
+ - id: ruff-check
23
+ - id: ruff-format
24
+ - repo: https://github.com/Knuckles-Team/pipelines
25
+ rev: main
26
+ hooks:
27
+ - id: connector-standard
28
+ - id: secrets
29
+ - id: spec
30
+ stages: [pre-push]
31
+ - id: tests-fast
32
+ stages: [pre-push]
@@ -6,7 +6,7 @@
6
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
7
 
8
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.
9
+ - **Setup:** run `uv sync --locked`, then `uvx pre-commit install --hook-type pre-commit --hook-type pre-push`.
10
10
  - **Gates:** `uvx pre-commit run --all-files` must pass before you push. Do not bypass hooks to get green.
11
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
12
  - **Org rules:** [organization AGENTS.md](https://github.com/Knuckles-Team/.github/blob/main/AGENTS.md).
@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [2.5.7] - 2026-10-27
9
+
10
+ ### Added
11
+ - Add the ArchiveBox rapid-delivery development skill and its package-content contract test.
12
+
13
+ ## [2.5.6] - 2026-10-24
14
+
15
+ ### Changed
16
+ - Central connector migration: requires `agent-connector-sdk>=0.5.3`; server bootstrap, version, containers, ontology artifacts, security scaffold and pre-commit config are provided centrally.
17
+
8
18
  ## [2.5.5] - 2026-10-23
9
19
 
10
20
  ### Changed
@@ -1,8 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: archivebox-api
3
- Version: 2.5.5
3
+ Version: 2.5.7
4
4
  Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
5
- Author-email: Project Maintainers <maintainers@users.noreply.github.com>
5
+ Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
7
7
  Classifier: Development Status :: 5 - Production/Stable
8
8
  Classifier: License :: Public Domain
@@ -12,11 +12,7 @@ Classifier: Programming Language :: Python :: 3
12
12
  Requires-Python: <3.15,>=3.12
13
13
  Description-Content-Type: text/markdown
14
14
  License-File: LICENSE
15
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1
16
- Provides-Extra: mcp
17
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1; extra == "mcp"
18
- Provides-Extra: all
19
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1; extra == "all"
15
+ Requires-Dist: agent-connector-sdk[mcp]<0.6.0,>=0.5.3
20
16
  Provides-Extra: test
21
17
  Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
22
18
  Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -46,8 +42,6 @@ Dynamic: license-file
46
42
  ![PyPI - Wheel](https://img.shields.io/pypi/wheel/archivebox-api)
47
43
  ![PyPI - Implementation](https://img.shields.io/pypi/implementation/archivebox-api)
48
44
 
49
- *Version: 2.5.5*
50
-
51
45
  > **Documentation** — Installation, deployment, usage across the API, CLI, MCP, and
52
46
  > A2A agent interfaces, and guidance for provisioning the ArchiveBox platform are
53
47
  > maintained in the [official documentation](https://knuckles-team.github.io/archivebox-api/).
@@ -20,8 +20,6 @@
20
20
  ![PyPI - Wheel](https://img.shields.io/pypi/wheel/archivebox-api)
21
21
  ![PyPI - Implementation](https://img.shields.io/pypi/implementation/archivebox-api)
22
22
 
23
- *Version: 2.5.5*
24
-
25
23
  > **Documentation** — Installation, deployment, usage across the API, CLI, MCP, and
26
24
  > A2A agent interfaces, and guidance for provisioning the ArchiveBox platform are
27
25
  > maintained in the [official documentation](https://knuckles-team.github.io/archivebox-api/).
@@ -85,3 +85,16 @@ def __getattr__(name: str) -> Any:
85
85
 
86
86
  def __dir__() -> list[str]:
87
87
  return sorted(list(globals().keys()) + __all__)
88
+
89
+
90
+ from agent_connector_sdk.connector import Connector
91
+
92
+ from archivebox_api.api_client import Api
93
+ from archivebox_api.auth import get_client
94
+
95
+ connector = Connector(
96
+ api=Api,
97
+ get_client=get_client,
98
+ tools="archivebox_api.mcp_server",
99
+ instructions="archivebox-api MCP Server — one typed tool per API operation.",
100
+ )
@@ -0,0 +1,4 @@
1
+ from agent_connector_sdk import run
2
+
3
+ if __name__ == "__main__":
4
+ run()
@@ -9,9 +9,6 @@ from __future__ import annotations
9
9
  from typing import Any
10
10
 
11
11
  from agent_connector_sdk.ingest.live_declaration import source_meta
12
- from agent_connector_sdk.ingest.sources import IngestSourceDeclaration, IngestSourceSpec
13
-
14
- CONNECTOR: str = "archivebox-mcp"
15
12
 
16
13
  SOURCES: tuple[Any, ...] = (
17
14
  source_meta(
@@ -35,17 +32,23 @@ SOURCES: tuple[Any, ...] = (
35
32
  ),
36
33
  )
37
34
 
35
+ SCHEMA_VERSION = 2
36
+
37
+ FIELD_SETS: dict[str, dict[str, str]] = {
38
+ "fields_1": {
39
+ "abid": "xsd:string",
40
+ "archiveStatus": "xsd:string",
41
+ "bookmarkedAt": "xsd:dateTime",
42
+ "extractor": "xsd:string",
43
+ "output": "xsd:string",
44
+ "sourceUrl": "xsd:string",
45
+ "timestamp": "xsd:string",
46
+ },
47
+ }
48
+
38
49
  SCHEMA_MAPPINGS: dict[str, Any] = {
39
50
  "ArchiveResult": {
40
- "fields": {
41
- "abid": "xsd:string",
42
- "archiveStatus": "xsd:string",
43
- "bookmarkedAt": "xsd:dateTime",
44
- "extractor": "xsd:string",
45
- "output": "xsd:string",
46
- "sourceUrl": "xsd:string",
47
- "timestamp": "xsd:string",
48
- },
51
+ "field_sets": ["fields_1"],
49
52
  "ontology_class": None,
50
53
  },
51
54
  "Chunk": {
@@ -85,15 +88,7 @@ SCHEMA_MAPPINGS: dict[str, Any] = {
85
88
  "ontology_class": "Document",
86
89
  },
87
90
  "Snapshot": {
88
- "fields": {
89
- "abid": "xsd:string",
90
- "archiveStatus": "xsd:string",
91
- "bookmarkedAt": "xsd:dateTime",
92
- "extractor": "xsd:string",
93
- "output": "xsd:string",
94
- "sourceUrl": "xsd:string",
95
- "timestamp": "xsd:string",
96
- },
91
+ "field_sets": ["fields_1"],
97
92
  "ontology_class": None,
98
93
  },
99
94
  }
@@ -120,23 +115,3 @@ RESOURCES: tuple[dict[str, str], ...] = (
120
115
  "name": "Chunk",
121
116
  },
122
117
  )
123
-
124
-
125
- def declaration() -> IngestSourceDeclaration:
126
- """The declaration the server assembles from this module."""
127
- specs: list[IngestSourceSpec] = []
128
- for item in SOURCES:
129
- for entry in item["connector_sources"]:
130
- body: dict[str, Any] = {
131
- k: v for k, v in entry.items() if k not in ("tool", "mapping")
132
- }
133
- spec = {**body, "tools": (entry["tool"],)}
134
- specs.append(IngestSourceSpec.model_validate(spec))
135
- return IngestSourceDeclaration.model_validate(
136
- {
137
- "connector": CONNECTOR,
138
- "sources": specs,
139
- "schema_mappings": SCHEMA_MAPPINGS,
140
- "resources": RESOURCES,
141
- }
142
- )
@@ -22,6 +22,7 @@ from __future__ import annotations
22
22
  import logging
23
23
  from typing import Any
24
24
 
25
+ from agent_connector_sdk.connector_identity import connector_name
25
26
  from agent_connector_sdk.ingest import (
26
27
  ChangeSet,
27
28
  Document,
@@ -37,7 +38,7 @@ from agent_connector_sdk.ingest import (
37
38
 
38
39
  logger = logging.getLogger("archivebox_api.kg")
39
40
 
40
- _SOURCE = "archivebox-api"
41
+ _SOURCE = connector_name("archivebox_api")
41
42
  _DOMAIN = "archivebox"
42
43
 
43
44
  _BINDING = IngestBinding(connector="archivebox-mcp", stream=_DOMAIN)
@@ -7,26 +7,17 @@ Provides dynamic tool registration and stdio/SSE/http interfaces using FastMCP.
7
7
 
8
8
  # Telemetry & Observability
9
9
  import logging
10
- import sys
11
10
  from typing import Any
12
11
 
13
- from agent_connector_sdk.config import load_config
14
12
  from agent_connector_sdk.mcp.action_dispatch import resolve_action
15
13
  from agent_connector_sdk.mcp.concurrency import run_blocking
16
- from agent_connector_sdk.mcp.server import create_mcp_server
17
- from agent_connector_sdk.mcp.tool_surface import register_tool_surface
18
14
  from fastmcp import Context, FastMCP
19
15
  from fastmcp.dependencies import Depends
20
16
  from fastmcp.utilities.logging import get_logger
21
17
  from pydantic import Field
22
- from starlette.requests import Request
23
- from starlette.responses import JSONResponse
24
18
 
25
- from archivebox_api.api_client import Api
26
19
  from archivebox_api.auth import get_client
27
20
 
28
- __version__ = "2.5.5"
29
-
30
21
  # Telemetry & Observability
31
22
  logger = get_logger(name="archivebox-api")
32
23
  logger.setLevel(logging.INFO)
@@ -355,61 +346,3 @@ def register_web_tools(mcp: FastMCP):
355
346
  from agent_connector_sdk.ports.web_source import register_web_source_tools
356
347
 
357
348
  register_web_source_tools(mcp, get_contract_source)
358
-
359
-
360
- def get_mcp_instance() -> tuple[Any, ...]:
361
- """Initialize and return the MCP instance."""
362
- load_config()
363
- from pathlib import Path
364
-
365
- from agent_connector_sdk.mcp.content import ConnectorContent
366
-
367
- package_root = Path(__file__).resolve().parent
368
- args, mcp, middlewares = create_mcp_server(
369
- name="archivebox-api MCP",
370
- version=__version__,
371
- instructions="archivebox-api MCP Server — one typed tool per API operation.",
372
- content=ConnectorContent(
373
- connector="archivebox-mcp",
374
- package_root=package_root,
375
- package_version=__version__,
376
- ),
377
- )
378
-
379
- @mcp.custom_route("/health", methods=["GET"])
380
- async def health_check(request: Request) -> JSONResponse:
381
- return JSONResponse({"status": "OK"})
382
-
383
- register_tool_surface(
384
- mcp,
385
- client_cls=Api,
386
- get_client=get_client,
387
- service="archivebox-api",
388
- tools_module=sys.modules[__name__],
389
- )
390
-
391
- for mw in middlewares:
392
- mcp.add_middleware(mw)
393
- return mcp, args, middlewares
394
-
395
-
396
- def mcp_server() -> None:
397
- mcp, args, middlewares = get_mcp_instance()
398
- print(f"archivebox-api MCP v{__version__}", file=sys.stderr)
399
- print("\nStarting MCP Server", file=sys.stderr)
400
- print(f" Transport: {args.transport.upper()}", file=sys.stderr)
401
- print(f" Auth: {args.auth_type}", file=sys.stderr)
402
-
403
- if args.transport == "stdio":
404
- mcp.run(transport="stdio")
405
- elif args.transport == "streamable-http":
406
- mcp.run(transport="streamable-http", host=args.host, port=args.port)
407
- elif args.transport == "sse":
408
- mcp.run(transport="sse", host=args.host, port=args.port)
409
- else:
410
- logger.error("Invalid transport", extra={"transport": args.transport})
411
- sys.exit(1)
412
-
413
-
414
- if __name__ == "__main__":
415
- mcp_server()
@@ -1,9 +1,9 @@
1
1
  {
2
- "api_version": "arbora.io/v1",
2
+ "api_version": "graphos.io/v1",
3
3
  "artifacts": {
4
- "archivebox_api/ontology/archivebox.ttl": "c04cd401a48b9a8fac59039afe1455c359387aff4a606b0dc861cfee7d6051b2",
4
+ "archivebox_api/ontology/archivebox.ttl": "db33f205707ef8bac5741b650698d38983fbd1ad787f552933ad5f12b642b7f1",
5
5
  "archivebox_api/ontology/fixtures/records.json": "dd1e07464a2be222f78443652363eadcf93250f97b2e2a456d5458e1f138c9c9",
6
- "archivebox_api/ontology/mappings/source.yaml": "3275cc71ab2339b1051e8a80a10c9098764c8e9447cd86942bb9dccbcb91eecf",
6
+ "archivebox_api/ontology/mappings/source.yaml": "db82464dd78924eab2ba6c77b6f934c5f4a8c416bb17ac9365c97ba1c170d951",
7
7
  "archivebox_api/ontology/migrations/manifest.json": "45125750a384f7077b2714d1392c91a630d12f8f0fa2aa1f86a345cd34582540",
8
8
  "archivebox_api/ontology/shapes/connector.shacl.ttl": "528406ea4d138e8f6bcc1e24f24675827ad52f772df96ad1e6cf0b14833a050e"
9
9
  },
@@ -15,7 +15,7 @@
15
15
  "synthetic_fixture_contract": "passed"
16
16
  },
17
17
  "compatibility": {
18
- "agent_connector_sdk": ">=2.5.0,<3",
18
+ "agent_utilities": ">=2.5.0,<3",
19
19
  "bundle_schema": "2",
20
20
  "epistemic_graph": ">=2.27.0,<3"
21
21
  },
@@ -29,5 +29,5 @@
29
29
  "signer": "UNSIGNED-PREVIEW",
30
30
  "signing_public_key": "",
31
31
  "status": "source-validated",
32
- "validated_at": "2026-08-26T13:42:55Z"
32
+ "validated_at": "2026-10-27T02:14:50Z"
33
33
  }
@@ -1,5 +1,5 @@
1
1
  schema_version: '1'
2
- connector: archivebox-api
2
+ connector: archivebox-mcp
3
3
  ontology_source: archivebox
4
4
  sync:
5
5
  - preset: archivebox-snapshots
@@ -0,0 +1,109 @@
1
+ ---
2
+ name: archivebox-api-development
3
+ skill_type: skill
4
+ description: >-
5
+ Develop and maintain the ArchiveBox connector while preserving its governed
6
+ API actions, web-source contract, credential boundary, package resources, and
7
+ public-first release evidence.
8
+ license: MIT
9
+ tags: [archivebox, connector, mcp, sdk, web-source, knowledge-graph]
10
+ metadata:
11
+ author: Genius
12
+ version: '0.1.0'
13
+ ---
14
+ # ArchiveBox API Development
15
+
16
+ This is the repository development skill for `archivebox-api`. The owning central
17
+ delivery row is `PIPE-CONNSPEC-R103.4`; use this skill with the repository
18
+ `AGENTS.md`, the connector-content and web-source specifications, and the
19
+ focused tests.
20
+
21
+ ## Repository and runtime map
22
+
23
+ - `archivebox_api/mcp_server.py` registers authentication, core, CLI, KG,
24
+ and web-source tools. Keep action names and the SDK Connector boundary stable.
25
+ - `archivebox_api/api_client.py` composes the authentication, core, and CLI
26
+ API wrappers. `archivebox_api/auth.py` injects endpoint credentials and the
27
+ SDK TLS profile through `get_client`; it must not persist secret values.
28
+ - `archivebox_api/connector_sources.py` is the live source and schema
29
+ declaration. Change declarations there rather than duplicating source IDs or
30
+ mappings in tool code.
31
+ - `archivebox_api/web_source.py` implements the SDK web-source contract:
32
+ keyless web discovery is separate from ArchiveBox REST authentication, while
33
+ extractor files use a logged-in Django session and bounded reads.
34
+ - `archivebox_api/kg_ingest.py` owns best-effort typed Snapshot, ArchiveResult,
35
+ Document, Chunk, Tag, and Blob ingestion through the SDK/epistemic-graph
36
+ boundary. Preserve stable IDs and no-op behavior when the engine is absent.
37
+ - `archivebox_api/skills/**`, `prompts/**`, `ontology/**`, and
38
+ `connectors/**` are package data. A skill change therefore needs a package
39
+ inclusion check before publication.
40
+
41
+ ## Connection and security contract
42
+
43
+ The REST client uses `ARCHIVEBOX_BASE_URL` with the `ARCHIVEBOX_URL` alias.
44
+ Bearer/API-key and basic-auth values come from injected `ARCHIVEBOX_TOKEN`,
45
+ `ARCHIVEBOX_API_KEY`, `ARCHIVEBOX_USERNAME`, and `ARCHIVEBOX_PASSWORD`
46
+ settings. Keep secrets out of source, skills, fixtures, logs, and test output.
47
+
48
+ Use the SDK TLS policy selected by `ARCHIVEBOX_TLS_PROFILE` and
49
+ `ARCHIVEBOX_TLS_PROFILE_REF`; `ArchiveSession` must keep certificate and
50
+ hostname verification governed by the shared resolver. Preserve the supported
51
+ `stdio`, `streamable-http`, and `sse` transports, the
52
+ `MCP_TOOL_MODE` surface selection, `WEBTOOL`/`WEB_SOURCETOOL` toggles,
53
+ and the `ARCHIVEBOX_KG_AUTO_INGEST` opt-out. Do not add a provider-specific
54
+ credential store or a TLS bypass.
55
+
56
+ ## Rapid delivery: the 5-minute contract
57
+
58
+ 1. Read the owning connector-content and web-source specs, this skill,
59
+ `AGENTS.md`, and the directly bound tests before changing a surface.
60
+ 2. Inspect the SDK `Connector`, action lists and dispatchers, API wrappers,
61
+ `ArchiveWebSource` session/refusal behavior, source declarations, KG
62
+ mappings, and package-data rules.
63
+ 3. Make the smallest connector-owned change. Preserve public action/tool names,
64
+ source IDs and mappings, keyless web fallbacks, injected credentials, TLS
65
+ verification, bounded extractor reads, stable KG IDs, and canonical/legacy
66
+ server paths.
67
+ 4. Run the smallest directly bound tests with
68
+ `uv run --locked --extra test pytest`, then run the repository hooks. Use
69
+ the approved narrow wrapper when the lane requires it; never bypass a hook or
70
+ failing gate.
71
+ 5. If package content changes, advance the version with the repository's normal
72
+ release metadata, refresh `uv.lock`, and inspect the built wheel and sdist
73
+ for the intended `archivebox_api/skills/**` bytes before publication.
74
+ 6. Treat Pages and containers as separate evidence. After the exact main commit
75
+ publishes, verify the Pages revision and `/spec-delivery/` artifacts. The
76
+ container workflow must wait for the exact public wheel guard; never move an
77
+ image pin before package proof.
78
+
79
+ ## Focused validation
80
+
81
+ For client, action, source, or KG changes, run only the smallest relevant test
82
+ file and keep keyless, credentialed, unavailable-authority, and refusal paths
83
+ distinct. For this skill/package-data change, verify frontmatter, the required
84
+ rapid-delivery heading, ArchiveBox-specific source references, package-data
85
+ inclusion, and absence of token-like material without contacting an external
86
+ provider.
87
+
88
+ Use repository commands from `AGENTS.md`:
89
+
90
+ ```bash
91
+ uv sync --locked
92
+ uv run --locked --extra test pytest -q tests/test_archivebox_development_skill.py
93
+ uvx pre-commit run --all-files
94
+ ```
95
+
96
+ ## Publication and Pages
97
+
98
+ `.github/workflows/pipeline.yml` publishes the package through
99
+ `Knuckles-Team/pipelines/.github/workflows/python_pipeline.yml@main` with
100
+ `connector: true`, then invokes the container pipeline with
101
+ `render_connector: true`. `.github/workflows/pages.yml` delegates the
102
+ README/docs path to `pages_pipeline.yml@main`. Keep package publication before
103
+ the generated connector image and preserve the public wheel/source fences.
104
+
105
+ A successful local test or workflow run is not package, Pages, or image proof.
106
+ Record the exact merged source, public wheel/sdist hashes, skill bytes, Pages
107
+ revision, and image digest separately. Do not hand-edit central Pipelines status,
108
+ promote a rollup from this skill change, or put credentials, provider data,
109
+ generated release artifacts, or bypass instructions in this skill.
@@ -1,8 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: archivebox-api
3
- Version: 2.5.5
3
+ Version: 2.5.7
4
4
  Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
5
- Author-email: Project Maintainers <maintainers@users.noreply.github.com>
5
+ Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
7
7
  Classifier: Development Status :: 5 - Production/Stable
8
8
  Classifier: License :: Public Domain
@@ -12,11 +12,7 @@ Classifier: Programming Language :: Python :: 3
12
12
  Requires-Python: <3.15,>=3.12
13
13
  Description-Content-Type: text/markdown
14
14
  License-File: LICENSE
15
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1
16
- Provides-Extra: mcp
17
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1; extra == "mcp"
18
- Provides-Extra: all
19
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1; extra == "all"
15
+ Requires-Dist: agent-connector-sdk[mcp]<0.6.0,>=0.5.3
20
16
  Provides-Extra: test
21
17
  Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
22
18
  Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -46,8 +42,6 @@ Dynamic: license-file
46
42
  ![PyPI - Wheel](https://img.shields.io/pypi/wheel/archivebox-api)
47
43
  ![PyPI - Implementation](https://img.shields.io/pypi/implementation/archivebox-api)
48
44
 
49
- *Version: 2.5.5*
50
-
51
45
  > **Documentation** — Installation, deployment, usage across the API, CLI, MCP, and
52
46
  > A2A agent interfaces, and guidance for provisioning the ArchiveBox platform are
53
47
  > maintained in the [official documentation](https://knuckles-team.github.io/archivebox-api/).
@@ -6,7 +6,6 @@ LICENSE
6
6
  MANIFEST.in
7
7
  README.md
8
8
  mkdocs.yml
9
- opencode.json
10
9
  pyproject.toml
11
10
  release-readiness.json
12
11
  requirements.txt
@@ -31,7 +30,6 @@ archivebox_api/api/api_client_auth.py
31
30
  archivebox_api/api/api_client_base.py
32
31
  archivebox_api/api/api_client_cli.py
33
32
  archivebox_api/api/api_client_core.py
34
- archivebox_api/connectors/__init__.py
35
33
  archivebox_api/ontology/__init__.py
36
34
  archivebox_api/ontology/archivebox.ttl
37
35
  archivebox_api/ontology/certification.json
@@ -39,9 +37,8 @@ archivebox_api/ontology/fixtures/records.json
39
37
  archivebox_api/ontology/mappings/source.yaml
40
38
  archivebox_api/ontology/migrations/manifest.json
41
39
  archivebox_api/ontology/shapes/connector.shacl.ttl
42
- archivebox_api/prompts/__init__.py
43
40
  archivebox_api/prompts/web_archivist_specialist.json
44
- archivebox_api/skills/__init__.py
41
+ archivebox_api/skills/archivebox-api-development/SKILL.md
45
42
  archivebox_api/skills/archivebox-api-operations/SKILL.md
46
43
  archivebox_api/skills/archivebox-api-operations/agents/openai.yaml
47
44
  archivebox_api/skills/archivebox-api-operations/references/catalog.md
@@ -51,16 +48,14 @@ archivebox_api/skills/archivebox-snapshot-search/SKILL.md
51
48
  archivebox_api/skills/archivebox-snapshot-search/WORKFLOW.md
52
49
  archivebox_api/skills/archivebox-web-archiving/SKILL.md
53
50
  archivebox_api/skills/archivebox-web-archiving/WORKFLOW.md
54
- scripts/security_sanitizer.py
55
- scripts/verify_api_integration.py
56
51
  tests/conftest.py
57
52
  tests/test_action_discovery.py
58
53
  tests/test_archivebox_api_brute_force_coverage.py
59
54
  tests/test_archivebox_coverage.py
60
55
  tests/test_archivebox_coverage_extra.py
56
+ tests/test_archivebox_development_skill.py
61
57
  tests/test_basic.py
62
58
  tests/test_conformance.py
63
- tests/test_default_content_surfaces.py
64
59
  tests/test_init_dynamics.py
65
60
  tests/test_kg_ingest.py
66
61
  tests/test_kg_media.py
@@ -0,0 +1,8 @@
1
+ [agent_connector_sdk.connector]
2
+ archivebox-mcp = archivebox_api:connector
3
+
4
+ [agent_connector_sdk.prompt_providers]
5
+ archivebox-api = archivebox_api.prompts
6
+
7
+ [console_scripts]
8
+ archivebox-mcp = agent_connector_sdk.cli:serve
@@ -0,0 +1,7 @@
1
+ agent-connector-sdk[mcp]<0.6.0,>=0.5.3
2
+
3
+ [test]
4
+ pytest-xdist>=3.8.0
5
+ pytest>=9.1.1
6
+ pytest-asyncio>=1.4.0
7
+ pytest-cov>=7.1.0
@@ -4,6 +4,5 @@ dist
4
4
  dist-sdist
5
5
  docker
6
6
  docs
7
- scripts
8
7
  specs
9
8
  tests
@@ -4,37 +4,29 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "archivebox-api"
7
- version = "2.5.5"
7
+ version = "2.5.7"
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",]
11
11
  requires-python = ">=3.12, <3.15"
12
- dependencies = [ "agent-connector-sdk[mcp]>=0.4.1,<1.0.0",]
12
+ dependencies = [ "agent-connector-sdk[mcp]>=0.5.3,<0.6.0",]
13
13
  [[project.authors]]
14
- name = "Project Maintainers"
15
- email = "maintainers@users.noreply.github.com"
14
+ name = "Repository Maintainers"
15
+ email = "maintainers@knuckles.team"
16
16
 
17
17
  [project.license]
18
18
  text = "MIT"
19
19
 
20
20
  [project.optional-dependencies]
21
- mcp = [ "agent-connector-sdk[mcp]>=0.4.1,<1.0.0",]
22
- all = [ "agent-connector-sdk[mcp]>=0.4.1,<1.0.0",]
23
21
  test = [
24
22
  "pytest-xdist>=3.8.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0",]
25
23
 
26
24
  [project.scripts]
27
- archivebox-mcp = "archivebox_api.mcp_server:mcp_server"
25
+ archivebox-mcp = "agent_connector_sdk.cli:serve"
28
26
 
29
27
  # The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
30
28
  [project.entry-points."agent_connector_sdk.connector"]
31
- archivebox-mcp = "archivebox_api"
32
-
33
- [project.entry-points."agent_connector_sdk.skill_providers"]
34
- archivebox-api = "archivebox_api.skills"
35
-
36
- [project.entry-points."agent_connector_sdk.ontology_providers"]
37
- archivebox-api = "archivebox_api.ontology"
29
+ archivebox-mcp = "archivebox_api:connector"
38
30
 
39
31
  [project.entry-points."agent_connector_sdk.prompt_providers"]
40
32
  archivebox-api = "archivebox_api.prompts"
@@ -51,6 +43,7 @@ override-dependencies = [
51
43
  ]
52
44
 
53
45
  [tool.ruff]
46
+ extend-exclude = ["tests", "scripts"]
54
47
  line-length = 88
55
48
  target-version = "py312"
56
49
 
@@ -79,3 +72,12 @@ ignore_names = ["request", "config", "connector"]
79
72
 
80
73
  [tool.pipelines_hooks.ste]
81
74
  exempt = ["specs/*", "specs/**/*"]
75
+
76
+ [tool.pipelines.container]
77
+ debug_apt = ["default-jre", "ripgrep", "tree", "fd-find", "curl", "nano", "build-essential", "cmake", "libssl-dev", "libcurl4-openssl-dev", "pkg-config", "cargo", "rustc"]
78
+
79
+ [tool.pipelines.codespell]
80
+ ignore_words = ["asser", "fo", "updat"]
81
+
82
+ [tool.pipelines.api_integration]
83
+ baseline = 26.6