archivebox-api 2.6.0__tar.gz → 2.6.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.
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/AGENTS.md +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/CHANGELOG.md +5 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/PKG-INFO +14 -14
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/README.md +12 -12
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api/api_client_base.py +2 -2
- archivebox_api-2.6.1/archivebox_api/connector_contracts.py +1699 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/kg_ingest.py +2 -2
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/__init__.py +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/access_contracts.ttl +9 -8
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/archivebox.ttl +21 -20
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/certification.json +3 -3
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/pack.ttl +84 -79
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/shapes/connector.shacl.ttl +2 -2
- archivebox_api-2.6.1/archivebox_api/prompts/archivebox_archive_administrator.json +133 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/prompts/archivebox_operator.json +136 -48
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/prompts/archivebox_research_archivist.json +58 -16
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-api-development/SKILL.md +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/web_source.py +2 -2
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/web_source_contract.py +2 -2
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api.egg-info/PKG-INFO +14 -14
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api.egg-info/SOURCES.txt +3 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api.egg-info/requires.txt +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/pyproject.toml +2 -2
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/release-readiness.json +125 -120
- archivebox_api-2.6.1/requirements.txt +1 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_archivebox_api_brute_force_coverage.py +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_archivebox_coverage.py +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_archivebox_coverage_extra.py +1 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_kg_ingest.py +1 -1
- archivebox_api-2.6.1/tests/test_scion_sdk_0_10_imports.py +59 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_sdk_transport.py +3 -3
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_surface_contracts.py +3 -2
- archivebox_api-2.6.0/requirements.txt +0 -1
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/.pre-commit-config.yaml +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/CLAUDE.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/LICENSE +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/MANIFEST.in +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/__init__.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/__main__.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api/__init__.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api/api_client_auth.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api/api_client_cli.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api/api_client_core.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api/api_client_crawls.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/api_client.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/auth.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/connector_sources.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/mcp_config.json +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/mcp_server.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/fixtures/records.json +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/mappings/source.yaml +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/ontology/migrations/manifest.json +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-api-operations/SKILL.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-api-operations/agents/openai.yaml +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-api-operations/references/catalog.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-archive-administration/SKILL.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-kg-ingestion/SKILL.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-research-archive/SKILL.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-snapshot-search/SKILL.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api/skills/archivebox-web-archiving/SKILL.md +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api.egg-info/dependency_links.txt +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api.egg-info/entry_points.txt +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/archivebox_api.egg-info/top_level.txt +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/mkdocs.yml +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/setup.cfg +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/conftest.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_archivebox_development_skill.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_basic.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_conformance.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_init_dynamics.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_kg_media.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/tests/test_publication_workflow.py +0 -0
- {archivebox_api-2.6.0 → archivebox_api-2.6.1}/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/
|
|
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.
|
|
3
|
+
Version: 2.6.1
|
|
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.
|
|
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
|
|
234
|
-
> still carries `
|
|
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 + `
|
|
336
|
-
| `archivebox-api[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `
|
|
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 `
|
|
357
|
-
| `example/archivebox-api@sha256:<digest>` | `--target agent` (default) | `archivebox-api[agent]` — **agent runtime**, model orchestration + `
|
|
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 (`
|
|
367
|
+
### Knowledge-graph database (`medulla`)
|
|
368
368
|
|
|
369
|
-
Both `[mcp]` and `[agent]` carry the **
|
|
370
|
-
|
|
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
|
-
**
|
|
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
|
-
[
|
|
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
|
|
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
|
|
212
|
-
> still carries `
|
|
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 + `
|
|
314
|
-
| `archivebox-api[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `
|
|
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 `
|
|
335
|
-
| `example/archivebox-api@sha256:<digest>` | `--target agent` (default) | `archivebox-api[agent]` — **agent runtime**, model orchestration + `
|
|
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 (`
|
|
345
|
+
### Knowledge-graph database (`medulla`)
|
|
346
346
|
|
|
347
|
-
Both `[mcp]` and `[agent]` carry the **
|
|
348
|
-
|
|
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
|
-
**
|
|
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
|
-
[
|
|
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
|
|
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
|
|
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 =
|
|
31
|
+
self._session = build_http_client(
|
|
32
32
|
HttpClientOptions(
|
|
33
33
|
base_url=self.url,
|
|
34
34
|
tls=self.tls_profile,
|