pkgs.ml
Activity Stats For agents Log in with GitHub

pkgs-ml

v0.0.43

pkgs.ml registry client and cache helpers

Repository Open docs Open in playground
Install
riot add pkgs-ml
riot.toml
pkgs-ml = "0.0.43"
Last release
May 15, 2026
License
Apache-2.0
Dependencies
2
Dependents
4
Installs
1
Published versions
33
Owner
@leostera@leostera
Examples (1)
cache_layout
README Expand

pkgs-ml

Client-side helpers for talking to the pkgs.ml registry.

pkgs-ml is not a general application package. It is the reusable library behind Riot's package-management tooling: sparse-index reads, registry cache layout, artifact download/materialization, and artifact publishing.

If you are building tooling that needs to consume or publish packages without reimplementing the registry protocol, start here.

Install

riot add pkgs-ml

What it gives you

  • Pkgs_ml.Registry_cache to compute the on-disk cache layout under ~/.riot/registry/<registry>/...;
  • Pkgs_ml.Sparse_index to read sparse-index config and package documents;
  • Pkgs_ml.Registry to fetch, cache, materialize, search, and publish releases.

Example

open Std

let cache =
  Pkgs_ml.Registry_cache.create
    ~registry_name:"pkgs.ml"
    ~riot_home:(Path.v "/tmp/demo-riot-home")
    ()
  |> Result.expect ~msg:"cache should be creatable"

let index_dir = Pkgs_ml.Registry_cache.index_dir cache
let archive = Pkgs_ml.Registry_cache.archive_path cache ~package_name:"std" ~version:"0.1.0"

A runnable example is included:

riot run -p pkgs-ml cache_layout

That example prints the cache layout and the derived sparse-index URL for a package document.

When to use it

Use pkgs-ml when you need:

  • local cache layout helpers;
  • sparse index parsing and URL derivation;
  • release materialization into src/<pkg>/<version>;
  • publishing via POST /v1/publish.

If you are building Riot's dependency solver or lock refresh machinery, this is the right level. If you are writing a general application, it is probably not.

Related packages

  • riot-deps builds dependency solving and lock refresh on top of this package.
  • riot-publish uses the same registry surface when uploading artifacts.
Installs
Downloads over the last 30 days, stacked by release.
Total installs
1
Downloads over the last 30 days
v0.0.430
v0.0.420
v0.0.410
v0.0.400
v0.0.390
Package status
Submission, indexing, and post-publish processing milestones for this release.
Submitted
May 15, 08:09 PM
Indexed
May 15, 08:09 PM
Searchable
May 15, 08:09 PM
Docs ready
May 15, 08:27 PM
Completed
Pending
Dependencies
Dependencies declared for this release.
Show 2 dependencies Expand
Dependents
Packages that currently depend on pkgs-ml.
Show 4 dependents Expand
Recent activity
Latest publication, indexing, and post-publish pipeline events recorded for this package.
Open full activity
Show 12 recent events Expand
  • Blocked
    pkgs-ml 0.0.43 attempt 3 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:43:43 PM
    Event
    Blocked
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    attempt 3 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "blocked",
  "attempt_count": 3,
  "error": "error: Unknown argument: pkgs-ml"
}
  • Build failed
    pkgs-ml 0.0.43 build · exit 1 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:43:41 PM
    Event
    Build failed
    Package
    pkgs-ml
    Version
    0.0.43
    Summary
    error: Unknown argument: pkgs-ml
    Facts
    build exit 1 artifact 6776e89b6d9f
    Artifacts
    Result key
    pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json
    Logs key
    pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/build.log
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "run_kind": "build",
  "result_key": "pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json",
  "logs_key": "pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 249,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: pkgs-ml",
  "stdout_excerpt": "error: Unknown argument: pkgs-ml"
}
  • Processing
    pkgs-ml 0.0.43 attempt 3 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:43:33 PM
    Event
    Processing
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    attempt 3 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "processing",
  "attempt_count": 3
}
  • Requeued
    pkgs-ml 0.0.43 attempt 2 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:38:00 PM
    Event
    Requeued
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    attempt 2 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "pending",
  "attempt_count": 2,
  "next_attempt_at": "2026-05-15T20:43:00.258Z",
  "error": "error: Unknown argument: pkgs-ml"
}
  • Build failed
    pkgs-ml 0.0.43 build · exit 1 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:37:58 PM
    Event
    Build failed
    Package
    pkgs-ml
    Version
    0.0.43
    Summary
    error: Unknown argument: pkgs-ml
    Facts
    build exit 1 artifact 6776e89b6d9f
    Artifacts
    Result key
    pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json
    Logs key
    pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/build.log
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "run_kind": "build",
  "result_key": "pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json",
  "logs_key": "pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 76,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: pkgs-ml",
  "stdout_excerpt": "error: Unknown argument: pkgs-ml"
}
  • Processing
    pkgs-ml 0.0.43 attempt 2 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:37:53 PM
    Event
    Processing
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    attempt 2 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "processing",
  "attempt_count": 2
}
  • Requeued
    pkgs-ml 0.0.43 attempt 1 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:27:42 PM
    Event
    Requeued
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    attempt 1 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "pending",
  "attempt_count": 1,
  "next_attempt_at": "2026-05-15T20:32:42.652Z",
  "error": "error: Unknown argument: pkgs-ml"
}
  • Docs ready
    pkgs-ml 0.0.43 docs · 2 json · doc.package_generation_completed · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:27:34 PM
    Event
    Docs ready
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    docs 2 json doc.package_generation_completed artifact 6776e89b6d9f
    Artifacts
    Result key
    pipelines/docs/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json
    Logs key
    pipelines/docs/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/command.log
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "run_kind": "docs",
  "output_prefix": "docs/pkgs-ml/0.0.43/",
  "public_docs_url": "https://docs.pkgs.ml/p/pkgs-ml/0.0.43/",
  "result_key": "pipelines/docs/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json",
  "logs_key": "pipelines/docs/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/command.log",
  "json_event_count": 2,
  "non_json_stdout_count": 0,
  "last_json_event_type": "doc.package_generation_completed"
}
  • Build failed
    pkgs-ml 0.0.43 build · exit 1 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:27:32 PM
    Event
    Build failed
    Package
    pkgs-ml
    Version
    0.0.43
    Summary
    error: Unknown argument: pkgs-ml
    Facts
    build exit 1 artifact 6776e89b6d9f
    Artifacts
    Result key
    pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json
    Logs key
    pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/build.log
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "run_kind": "build",
  "result_key": "pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/result.json",
  "logs_key": "pipelines/builds/pkgs-ml/0.0.43/6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 67,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: pkgs-ml",
  "stdout_excerpt": "error: Unknown argument: pkgs-ml"
}
  • Processing
    pkgs-ml 0.0.43 attempt 1 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:27:21 PM
    Event
    Processing
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    attempt 1 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "processing",
  "attempt_count": 1
}
  • Queued
    pkgs-ml 0.0.43 artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:09:44 PM
    Event
    Queued
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "status": "pending"
}
  • Indexed
    pkgs-ml 0.0.43 latest 0.0.43 · artifact 6776e89b6d9f
    Details
    When
    May 15, 2026, 08:09:40 PM
    Event
    Indexed
    Package
    pkgs-ml
    Version
    0.0.43
    Facts
    latest 0.0.43 artifact 6776e89b6d9f
    Payload
    {
  "artifact_sha256": "6776e89b6d9f19ac90165d4c305dcada28fff830b3e24cb2daf4b6bfe62b2535",
  "latest": "0.0.43",
  "package_index_key": "index/v1/pk/gs/pkgs-ml.json",
  "package_index_url": "https://cdn.pkgs.ml/index/v1/pk/gs/pkgs-ml.json",
  "changed": true
}