archivebox-api 2.6.0__tar.gz → 2.7.0__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 (73) hide show
  1. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/AGENTS.md +1 -1
  2. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/CHANGELOG.md +5 -0
  3. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/PKG-INFO +14 -14
  4. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/README.md +12 -12
  5. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api/api_client_base.py +2 -2
  6. archivebox_api-2.7.0/archivebox_api/connector_contracts.py +1699 -0
  7. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/kg_ingest.py +2 -2
  8. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/__init__.py +1 -1
  9. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/access_contracts.ttl +9 -8
  10. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/archivebox.ttl +21 -20
  11. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/certification.json +3 -3
  12. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/pack.ttl +84 -79
  13. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/shapes/connector.shacl.ttl +2 -2
  14. archivebox_api-2.7.0/archivebox_api/prompts/archivebox_archive_administrator.json +133 -0
  15. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/prompts/archivebox_operator.json +136 -48
  16. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/prompts/archivebox_research_archivist.json +58 -16
  17. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-api-development/SKILL.md +1 -1
  18. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/web_source.py +2 -2
  19. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/web_source_contract.py +2 -2
  20. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api.egg-info/PKG-INFO +14 -14
  21. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api.egg-info/SOURCES.txt +3 -1
  22. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api.egg-info/requires.txt +1 -1
  23. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/pyproject.toml +2 -2
  24. archivebox_api-2.7.0/requirements.txt +1 -0
  25. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_archivebox_api_brute_force_coverage.py +1 -1
  26. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_archivebox_coverage.py +1 -1
  27. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_archivebox_coverage_extra.py +1 -1
  28. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_kg_ingest.py +1 -1
  29. archivebox_api-2.7.0/tests/test_scion_sdk_0_10_imports.py +59 -0
  30. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_sdk_transport.py +3 -3
  31. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_surface_contracts.py +3 -2
  32. archivebox_api-2.6.0/release-readiness.json +0 -5978
  33. archivebox_api-2.6.0/requirements.txt +0 -1
  34. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/.pre-commit-config.yaml +0 -0
  35. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/CLAUDE.md +0 -0
  36. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/LICENSE +0 -0
  37. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/MANIFEST.in +0 -0
  38. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/__init__.py +0 -0
  39. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/__main__.py +0 -0
  40. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api/__init__.py +0 -0
  41. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api/api_client_auth.py +0 -0
  42. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api/api_client_cli.py +0 -0
  43. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api/api_client_core.py +0 -0
  44. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api/api_client_crawls.py +0 -0
  45. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/api_client.py +0 -0
  46. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/auth.py +0 -0
  47. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/connector_sources.py +0 -0
  48. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/mcp_config.json +0 -0
  49. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/mcp_server.py +0 -0
  50. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/fixtures/records.json +0 -0
  51. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/mappings/source.yaml +0 -0
  52. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/ontology/migrations/manifest.json +0 -0
  53. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-api-operations/SKILL.md +0 -0
  54. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-api-operations/agents/openai.yaml +0 -0
  55. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-api-operations/references/catalog.md +0 -0
  56. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-archive-administration/SKILL.md +0 -0
  57. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-kg-ingestion/SKILL.md +0 -0
  58. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-research-archive/SKILL.md +0 -0
  59. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-snapshot-search/SKILL.md +0 -0
  60. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api/skills/archivebox-web-archiving/SKILL.md +0 -0
  61. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api.egg-info/dependency_links.txt +0 -0
  62. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api.egg-info/entry_points.txt +0 -0
  63. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/archivebox_api.egg-info/top_level.txt +0 -0
  64. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/mkdocs.yml +0 -0
  65. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/setup.cfg +0 -0
  66. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/conftest.py +0 -0
  67. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_archivebox_development_skill.py +0 -0
  68. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_basic.py +0 -0
  69. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_conformance.py +0 -0
  70. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_init_dynamics.py +0 -0
  71. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_kg_media.py +0 -0
  72. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_publication_workflow.py +0 -0
  73. {archivebox_api-2.6.0 → archivebox_api-2.7.0}/tests/test_web_source.py +0 -0
@@ -276,7 +276,7 @@ Working in parallel with other sessions/worktrees? **Reserve a concept id before
276
276
  scion-sdk --json concept reserve --ns EG-KG.compute.backend # or a package prefix, e.g. KEY
277
277
  ```
278
278
 
279
- Full protocol (ledger, merge=union, reconcile, MCP/REST): <https://knuckles-team.github.io/agent-connector-sdk/concept_coordination/>
279
+ Full protocol (ledger, merge=union, reconcile, MCP/REST): <https://knuckles-team.github.io/scion-sdk/concept_coordination/>
280
280
  <!-- END concept-coordination (generated) -->
281
281
 
282
282
  ## Version & lockfile drift edict (keep the version mirrors AND the lock in sync)
@@ -5,6 +5,11 @@ 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.6.1] - 2026-11-06
9
+
10
+ ### Changed
11
+ - Surface backfill: 12 tool-use contracts covering all 50 tools, agent definitions for the operator and two business roles, data locations, scion-sdk 0.9
12
+
8
13
  ## [2.6.0] - 2026-11-06
9
14
 
10
15
  ### Changed
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: archivebox-api
3
- Version: 2.6.0
3
+ Version: 2.7.0
4
4
  Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
5
5
  Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
@@ -12,7 +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: scion-sdk[mcp]<0.7.0,>=0.6.4
15
+ Requires-Dist: scion-sdk[mcp]<0.12,>=0.11.0
16
16
  Provides-Extra: test
17
17
  Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
18
18
  Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -230,8 +230,8 @@ Refer to [docs/index.md](docs/index.md) for full developer SDK and class referen
230
230
  ## MCP Server Setup
231
231
 
232
232
  > **Install the connector-focused `[mcp]` extra.** Examples use `archivebox-api[mcp]` to add
233
- > FastMCP / FastAPI through `scion-sdk[mcp]`; the required Agent Utilities core
234
- > still carries `epistemic-graph[full]`. The `[agent]` extra also
233
+ > FastMCP / FastAPI through `scion-sdk[mcp]`; the required Meristem core
234
+ > still carries `medulla[full]`. The `[agent]` extra also
235
235
  > enables model orchestration.
236
236
 
237
237
  This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.
@@ -332,8 +332,8 @@ Pick the extra that matches what the operator want to run:
332
332
 
333
333
  | Extra | Installs | Use when |
334
334
  |-------|----------|----------|
335
- | `archivebox-api[mcp]` | Connector-focused MCP server (`scion-sdk[mcp]` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
336
- | `archivebox-api[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `epistemic-graph[full]`) | The operator run the **integrated agent** |
335
+ | `archivebox-api[mcp]` | Connector-focused MCP server (`scion-sdk[mcp]` — FastMCP/FastAPI + `medulla[full]`) | The operator only run the **MCP server** (smallest install / image) |
336
+ | `archivebox-api[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `medulla[full]`) | The operator run the **integrated agent** |
337
337
  | `archivebox-api[all]` | Everything (`mcp` + `agent` + `logfire`) | Development / both surfaces |
338
338
 
339
339
  ```bash
@@ -353,8 +353,8 @@ One multi-stage `docker/Dockerfile` builds two right-sized images, selected by `
353
353
 
354
354
  | Image tag | Build target | Contents | Entrypoint |
355
355
  |-----------|--------------|----------|------------|
356
- | `example/archivebox-api:mcp` | `--target mcp` | `archivebox-api[mcp]` — **connector-focused**, includes `epistemic-graph[full]`; no model-orchestration stack | `archivebox-mcp` |
357
- | `example/archivebox-api@sha256:<digest>` | `--target agent` (default) | `archivebox-api[agent]` — **agent runtime**, model orchestration + `epistemic-graph[full]` | `archivebox-agent` |
356
+ | `example/archivebox-api:mcp` | `--target mcp` | `archivebox-api[mcp]` — **connector-focused**, includes `medulla[full]`; no model-orchestration stack | `archivebox-mcp` |
357
+ | `example/archivebox-api@sha256:<digest>` | `--target agent` (default) | `archivebox-api[agent]` — **agent runtime**, model orchestration + `medulla[full]` | `archivebox-agent` |
358
358
 
359
359
  ```bash
360
360
  docker build --target mcp -t example/archivebox-api:mcp docker/ # connector-focused MCP server
@@ -364,16 +364,16 @@ docker build --target agent -t example/archivebox-api:agent-local docker/ # ag
364
364
  `docker/mcp.compose.yml` runs the connector-focused `:mcp` server; `docker/agent.compose.yml` runs the
365
365
  agent (`immutable agent digest`) with a co-located `:mcp` sidecar.
366
366
 
367
- ### Knowledge-graph database (`epistemic-graph`)
367
+ ### Knowledge-graph database (`medulla`)
368
368
 
369
- Both `[mcp]` and `[agent]` carry the **epistemic-graph** engine through the required
370
- Agent Utilities core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
369
+ Both `[mcp]` and `[agent]` carry the **medulla** engine through the required
370
+ Meristem core dependency (`medulla[full]`). The `[mcp]` extra keeps
371
371
  the server connector-focused; `[agent]` also enables model orchestration. Local
372
372
  deployments can use the bundled engine. For production or shared state, run
373
- **epistemic-graph as a dedicated database service** and configure the runtime to use it.
373
+ **medulla as a dedicated database service** and configure the runtime to use it.
374
374
  Deployment recipes (single-node + Raft HA), connection configuration, and architecture
375
375
  diagrams are documented in the
376
- [epistemic-graph deployment guide](https://knuckles-team.github.io/epistemic-graph/deployment/).
376
+ [medulla deployment guide](https://knuckles-team.github.io/medulla/deployment/).
377
377
 
378
378
  ---
379
379
 
@@ -419,7 +419,7 @@ The table below is auto-generated from the live server — do not edit by hand.
419
419
  | `archivebox_cli` | `CLITOOL` | Manage archivebox cli operations. |
420
420
  | `archivebox_core` | `CORETOOL` | Manage archivebox core operations. |
421
421
  | `archivebox_ingest_archiveresults` | `KGTOOL` | List ArchiveBox archive results and ingest them as :ArchiveResult nodes. |
422
- | `archivebox_ingest_snapshots` | `KGTOOL` | List ArchiveBox snapshots and natively ingest them into epistemic-graph. |
422
+ | `archivebox_ingest_snapshots` | `KGTOOL` | List ArchiveBox snapshots and natively ingest them into medulla. |
423
423
 
424
424
  #### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
425
425
 
@@ -208,8 +208,8 @@ Refer to [docs/index.md](docs/index.md) for full developer SDK and class referen
208
208
  ## MCP Server Setup
209
209
 
210
210
  > **Install the connector-focused `[mcp]` extra.** Examples use `archivebox-api[mcp]` to add
211
- > FastMCP / FastAPI through `scion-sdk[mcp]`; the required Agent Utilities core
212
- > still carries `epistemic-graph[full]`. The `[agent]` extra also
211
+ > FastMCP / FastAPI through `scion-sdk[mcp]`; the required Meristem core
212
+ > still carries `medulla[full]`. The `[agent]` extra also
213
213
  > enables model orchestration.
214
214
 
215
215
  This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.
@@ -310,8 +310,8 @@ Pick the extra that matches what the operator want to run:
310
310
 
311
311
  | Extra | Installs | Use when |
312
312
  |-------|----------|----------|
313
- | `archivebox-api[mcp]` | Connector-focused MCP server (`scion-sdk[mcp]` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
314
- | `archivebox-api[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `epistemic-graph[full]`) | The operator run the **integrated agent** |
313
+ | `archivebox-api[mcp]` | Connector-focused MCP server (`scion-sdk[mcp]` — FastMCP/FastAPI + `medulla[full]`) | The operator only run the **MCP server** (smallest install / image) |
314
+ | `archivebox-api[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `medulla[full]`) | The operator run the **integrated agent** |
315
315
  | `archivebox-api[all]` | Everything (`mcp` + `agent` + `logfire`) | Development / both surfaces |
316
316
 
317
317
  ```bash
@@ -331,8 +331,8 @@ One multi-stage `docker/Dockerfile` builds two right-sized images, selected by `
331
331
 
332
332
  | Image tag | Build target | Contents | Entrypoint |
333
333
  |-----------|--------------|----------|------------|
334
- | `example/archivebox-api:mcp` | `--target mcp` | `archivebox-api[mcp]` — **connector-focused**, includes `epistemic-graph[full]`; no model-orchestration stack | `archivebox-mcp` |
335
- | `example/archivebox-api@sha256:<digest>` | `--target agent` (default) | `archivebox-api[agent]` — **agent runtime**, model orchestration + `epistemic-graph[full]` | `archivebox-agent` |
334
+ | `example/archivebox-api:mcp` | `--target mcp` | `archivebox-api[mcp]` — **connector-focused**, includes `medulla[full]`; no model-orchestration stack | `archivebox-mcp` |
335
+ | `example/archivebox-api@sha256:<digest>` | `--target agent` (default) | `archivebox-api[agent]` — **agent runtime**, model orchestration + `medulla[full]` | `archivebox-agent` |
336
336
 
337
337
  ```bash
338
338
  docker build --target mcp -t example/archivebox-api:mcp docker/ # connector-focused MCP server
@@ -342,16 +342,16 @@ docker build --target agent -t example/archivebox-api:agent-local docker/ # ag
342
342
  `docker/mcp.compose.yml` runs the connector-focused `:mcp` server; `docker/agent.compose.yml` runs the
343
343
  agent (`immutable agent digest`) with a co-located `:mcp` sidecar.
344
344
 
345
- ### Knowledge-graph database (`epistemic-graph`)
345
+ ### Knowledge-graph database (`medulla`)
346
346
 
347
- Both `[mcp]` and `[agent]` carry the **epistemic-graph** engine through the required
348
- Agent Utilities core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
347
+ Both `[mcp]` and `[agent]` carry the **medulla** engine through the required
348
+ Meristem core dependency (`medulla[full]`). The `[mcp]` extra keeps
349
349
  the server connector-focused; `[agent]` also enables model orchestration. Local
350
350
  deployments can use the bundled engine. For production or shared state, run
351
- **epistemic-graph as a dedicated database service** and configure the runtime to use it.
351
+ **medulla as a dedicated database service** and configure the runtime to use it.
352
352
  Deployment recipes (single-node + Raft HA), connection configuration, and architecture
353
353
  diagrams are documented in the
354
- [epistemic-graph deployment guide](https://knuckles-team.github.io/epistemic-graph/deployment/).
354
+ [medulla deployment guide](https://knuckles-team.github.io/medulla/deployment/).
355
355
 
356
356
  ---
357
357
 
@@ -397,7 +397,7 @@ The table below is auto-generated from the live server — do not edit by hand.
397
397
  | `archivebox_cli` | `CLITOOL` | Manage archivebox cli operations. |
398
398
  | `archivebox_core` | `CORETOOL` | Manage archivebox core operations. |
399
399
  | `archivebox_ingest_archiveresults` | `KGTOOL` | List ArchiveBox archive results and ingest them as :ArchiveResult nodes. |
400
- | `archivebox_ingest_snapshots` | `KGTOOL` | List ArchiveBox snapshots and natively ingest them into epistemic-graph. |
400
+ | `archivebox_ingest_snapshots` | `KGTOOL` | List ArchiveBox snapshots and natively ingest them into medulla. |
401
401
 
402
402
  #### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
403
403
 
@@ -7,7 +7,7 @@ from scion_sdk.exceptions import (
7
7
  AuthError,
8
8
  MissingParameterError,
9
9
  )
10
- from scion_sdk.http.client import create_http_client
10
+ from scion_sdk.http.client import build_http_client
11
11
  from scion_sdk.http.options import HttpClientOptions
12
12
  from scion_sdk.tls.profile import ResolvedTLSProfile
13
13
  from scion_sdk.tls.resolve import resolve_tls_profile
@@ -28,7 +28,7 @@ class BaseApiClient(ABC):
28
28
 
29
29
  self.tls_profile = tls_profile or resolve_tls_profile("archivebox")
30
30
  self.url = url.rstrip("/")
31
- self._session = create_http_client(
31
+ self._session = build_http_client(
32
32
  HttpClientOptions(
33
33
  base_url=self.url,
34
34
  tls=self.tls_profile,