katsoft-llm-kit 1.0.0__py3-none-any.whl

katsoft_llm_kit-1.0.0.dist-info/METADATA

@@ -0,0 +1,59 @@
+Metadata-Version: 2.5
+Name: katsoft-llm-kit
+Version: 1.0.0
+Summary: LLM access, durable agent jobs and batch content pipelines in one library (import package llm_kit)
+Project-URL: Source, https://github.com/kitaekatt/plugins-kit/tree/katsoft-llm-kit-v1.0.0
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: katsoft-contracts<2,>=1.0
+Provides-Extra: config
+Requires-Dist: pyyaml>=6.0; extra == 'config'
+Provides-Extra: frontdoor
+Requires-Dist: fastapi>=0.110; extra == 'frontdoor'
+Requires-Dist: httpx>=0.27; extra == 'frontdoor'
+Requires-Dist: uvicorn>=0.29; extra == 'frontdoor'
+Provides-Extra: jobs
+Requires-Dist: pyyaml>=6.0; extra == 'jobs'
+Provides-Extra: local
+Requires-Dist: psutil>=6.0; extra == 'local'
+Provides-Extra: pipeline
+Requires-Dist: pyyaml>=6.0; extra == 'pipeline'
+Provides-Extra: sdk
+Requires-Dist: openai>=1.0.0; extra == 'sdk'
+Description-Content-Type: text/markdown
+
+# katsoft-llm-kit
+
+LLM access, durable agent jobs and batch content pipelines in one library.
+The import package is `llm_kit`; the console script is `llm-kit`.
+
+```
+pip install katsoft-llm-kit
+pip install "katsoft-llm-kit[sdk,jobs,config]"
+llm-kit --help
+```
+
+The base install depends on `katsoft-contracts` (execution-event envelope,
+interrupt contract, model declaration parser) and nothing else. Extras:
+`config`, `jobs` and `pipeline` bring PyYAML; `sdk` brings the OpenAI client
+(the OpenRouter HTTP path); `local` brings psutil; `frontdoor` brings
+FastAPI, uvicorn and httpx.
+
+## Runtime mode
+
+`llm_kit._runtime.mode()` reports how the library is deployed. This
+distribution is `"package"`: the contracts come from `katsoft-contracts`, and
+the features that need the plugin marketplace's `bootstrap_lib` (the Codex
+adapter, claudx propagation, skill context, the code-review lane) raise
+`UnsupportedInPackageMode`. The model registry reads the shipped defaults;
+point `MODEL_ENDPOINTS_REGISTRY` at a registry file to change them.
+
+Do not install this distribution into an environment that also holds the
+plugin's linked `llm_kit` copy.
+
+## Source
+
+The source lives in the plugins-kit repository (`plugins/llm-kit/lib/llm_kit`).
+Releases are tagged `katsoft-llm-kit-v<version>` in the repository named by the
+`Source` project URL.

katsoft_llm_kit-1.0.0.dist-info/RECORD

@@ -0,0 +1,177 @@
+llm_kit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+llm_kit/_runtime.py,sha256=s45_AUkrfs4RZYiA5lmWu7KGWSMxdeZgCJhW6vVMuEk,10223
+llm_kit/bootstrap_guard.py,sha256=HuZyhwh5HGRrbQUNz_uHJkcUJ6lAXD0m2RVSSwZ3NHI,11954
+llm_kit/index.html,sha256=hx8HanvKqGeETZki6TDA8IELKYBAEmymIxgC4Erklvs,6815
+llm_kit/adapters/__init__.py,sha256=3iK3aksaiLBiBGsP-94s7ASPGSY6gHJdQTs10sZXuMA,1003
+llm_kit/adapters/_swapper_errors.py,sha256=ZpmlSzeLuKlQbPJGtIaV4lksjARSnREjir0ABnquuHo,888
+llm_kit/adapters/_swapper_process.py,sha256=YE-r4XVPhteACT97-qm2XdlvLmI9NMItE9ersVYFYn0,11541
+llm_kit/adapters/account.py,sha256=gTIGvFzTchDE3K5rqPjRmqUB_dg_waXgpVjiFvHhZw4,16649
+llm_kit/adapters/backends.py,sha256=6oG35mF6hZpPdzLRhKd8XgnNaOO0CI4ALkD-ScRdd5w,43990
+llm_kit/adapters/capabilities.py,sha256=XcamCE1IIWiISaV2yIt4T07255yOjFdKpmLGWHpRW-w,37550
+llm_kit/adapters/claude_runner.py,sha256=4_D5Ym_F7neT_ZE8Xk8Gfkpj_qXnBjrQgtxbJl2v6xQ,9312
+llm_kit/adapters/client.py,sha256=CJM068251pPTTkm89GHjRXY9fYJqnrNexAN31iu-FO8,4330
+llm_kit/adapters/codex_backend.py,sha256=GLpFj72JkELeAkAbE2l4zV62X53dba7Tad6t5L8Mf7s,35054
+llm_kit/adapters/endpoint_profile.py,sha256=zXvoO8gjjgpZucr5IQwQaA2lZYhQugagTVNhcgQVz5M,5300
+llm_kit/adapters/harness_adapters.py,sha256=XnTWuMEZnA1C_xMyQvKGfBK1AjhI1sCvc2a0qVXCqL4,16108
+llm_kit/adapters/harness_auth.py,sha256=nn47dZ330SKWJOZxCKzWDEQEe-MGde8Ie0YEwVMTTi0,8938
+llm_kit/adapters/opencode_backend.py,sha256=J40NVjjTRmsauB4cdy7RymeZ_Jvp4bdAmVNDTI0NXSE,21392
+llm_kit/adapters/swapper.py,sha256=P1fBJX94-dQGhG0dFQMxjcd_gXGimxFJo-L_qofYWwk,31917
+llm_kit/adapters/swapper_acceptance.py,sha256=nWLkyMmT9EnpO-TLAkv8fDTcXZBbRtqp5wc6Pcj5nZc,13213
+llm_kit/adapters/usage_sources.py,sha256=otJ9wLQ705XViG0iNSGGds2eF4Lo0_fDrt9G5NwOJiI,22115
+llm_kit/cli/__init__.py,sha256=pcRD1JSZa8TQ6XZrmHx9ki3DOkCTYrcQZJqzP9BPMy8,7617
+llm_kit/cli/__main__.py,sha256=q_ZgF8A5sm66CeudRvbP5TZACDFS0zjDxY_G_935dMU,162
+llm_kit/cli/_common.py,sha256=77uXgcuof86plCWQKKLDRUSpRtmuMnu67T-cCyunUlo,6216
+llm_kit/cli/_compose.py,sha256=H4R3tG7bSTdjB4Kg-Vj-yQBvBQmCTbmrRiKKg1Pko2A,1289
+llm_kit/cli/account.py,sha256=uy3XrmKjYmBfAQzOvYXFyRJAAnDA25lVLFkUB8yWtl4,5612
+llm_kit/cli/completion.py,sha256=OI3VRtNPhUv1z_5twlHDjrc9Fwvsp2YhdJbHWcKx_uw,26670
+llm_kit/cli/consent.py,sha256=I-iYBVzTSJanWXg24OqI69XzqwN41SsVsL75U2aaB_Q,3656
+llm_kit/cli/jobs.py,sha256=0vRgTzP9c_4bVSiTbfMEvd1_Fa4bltT96gTi6FYwgps,17636
+llm_kit/cli/local.py,sha256=K0hjzvj3XaNW3NzowJiegZ1_Zi7FdoQw3LFBw6RbN3g,13438
+llm_kit/cli/models.py,sha256=E2rQx8_13kWPRzOfvDSozVVx1B7aMdj5WFSSK3-2q-4,23569
+llm_kit/cli/pipeline.py,sha256=YJmgZaBxplOFi2811ooxyKz-uOiHlaDL3iX4UBvNfuY,2674
+llm_kit/cli/run.py,sha256=CM7ImmchZYQhf_Nhashs8uDQko28bWbDV-U6R-ic76o,29205
+llm_kit/completion/__init__.py,sha256=UNXnc1sJZ9vzfybi7hrhqniruGU9fD8jgrYK_w7kguQ,840
+llm_kit/completion/capabilities.py,sha256=d-ED9ETKE0n_tx8EjhqBC3iipKKf3oM95kIvRR8h8ks,19599
+llm_kit/completion/contract.py,sha256=2kJm1kTP2ZtduabECTNBiKr78s_FY5ArCpYoFfFiI4o,18767
+llm_kit/completion/contract_types.py,sha256=bir-jzmkf_Vc2pGQS0rHK_-prP3H9ihhKjRDTtoh3jM,18814
+llm_kit/completion/factory_protocols.py,sha256=GU2bVAlPiZjC0VEjRfs-Uqi_Dgt7MzDGgZGBeDv3xP8,3651
+llm_kit/completion/halt.py,sha256=9e_DmrCYG6WII54Ebki_WQ0qUqd13w6mpsVkJQwrfpA,22925
+llm_kit/completion/prompt_fold.py,sha256=ELq8Eb6F6duX1GVRSbQNCmMFTbVPkXMq2tqlmfMmGMs,1357
+llm_kit/completion/request_protocol.py,sha256=DxIrA3bX9hGspTgnLvryECpFRtqCGlGCjP9jRnQh6Zw,16452
+llm_kit/completion/requirements.py,sha256=Yj_uFw0mH0n6VayUKOWzwdaOuzmc7KcJKpaTh9fBiO8,17457
+llm_kit/completion/results.py,sha256=nIEchY5ML0k9JjuLpCGgIKXUv40BUT8NKa_LdE6DL8c,8748
+llm_kit/completion/skill_context.py,sha256=ryi3N79sx0StH7ySVXS_-WdiNJQabtERrnujXB12hX8,13770
+llm_kit/completion/skill_context_types.py,sha256=vhtvRHEOg4YH43mxzvPLMvCZSK5-xY9c4ZsnP5Ddg2Q,5182
+llm_kit/completion/types.py,sha256=_otAmYp06ZInVMFZgJikRsOF1zBRfNbSuM9IiILqlco,18823
+llm_kit/dispatch/__init__.py,sha256=jq516vPT3hQsF75SXbv3vnbwB6ucKfQ0hlStcPzPoHM,951
+llm_kit/dispatch/declaration.py,sha256=Sts0BAduq6sH_7tZ-CHZaoFYSCqj3T60rkmdlmQUJoA,57710
+llm_kit/dispatch/endpoint_profile.py,sha256=kQwFmsWourT2QD4P2usGJB5Ks5U0beyaYh08PsvNBIY,754
+llm_kit/dispatch/endpoint_resolver.py,sha256=08wjvsoPOajs5iz8xTgrPEEKmDrgxwwy-1t5-pxtq8s,6347
+llm_kit/dispatch/factory.py,sha256=BSsih-1A1NoVA22e7p7OsyJrwOoahukCRFXRhqTaJtA,6694
+llm_kit/dispatch/observer.py,sha256=Bea1ppufgbqbjoaDXDWB3kGxAZdQCkg2BVO5LFyEK8Y,1002
+llm_kit/dispatch/pipeline_backends.py,sha256=3ttibBBEZ3cmQrlOMChp4jh9w-jahFH-5GC16cqTY8E,8515
+llm_kit/dispatch/reachability.py,sha256=MAPQoJEtoHISHNBfxVvHnFe9uMVgYzI3T1bLTXC8p8M,20127
+llm_kit/dispatch/review_lane.py,sha256=AzD7NosLOEhreaZfoPNAmpJLWVPyeipou9_7Ej-_c-k,34190
+llm_kit/dispatch/seats.py,sha256=dFRAriA267bBrvqQr70eqhink3rd8F4lLhgnZuN6cPo,11876
+llm_kit/dispatch/usage_budget.py,sha256=XsHbfZMYyncdDsfzZptCglXpepmXuk9fp0lqhKucpyk,18538
+llm_kit/execution/__init__.py,sha256=zhuS8MQ8WJH_5iT_UeYjT8Lg7Xcme1zljpyqu3tFDew,1166
+llm_kit/execution/contract_probe.py,sha256=UtqYSfqufyoAidQutr25beidHhFbtm8XyPVQw7WNQ30,5855
+llm_kit/execution/event_probe.py,sha256=-CgBHjqcOpGIACs4WkxheLILqYtvD4l4z0mkAkDZ4a8,7157
+llm_kit/execution/interrupts.py,sha256=2vOVL6xd-XEb0wzNrl41LI2mHuiiCnJqjUmShUOkyt8,11072
+llm_kit/execution/probe.py,sha256=vGx0-a8gD1ZeRwRmPb66nH8VU58ywtWgaXZsSWBeFWc,6424
+llm_kit/execution/schema_validator.py,sha256=TqweCvlS5Na65FUha1cwYqAYL60wcyecSL0WJMucguo,3643
+llm_kit/execution/values.py,sha256=dwV6rAtnR5M5s5hZ_hwtbC4zbPyp6BOqOleexmVH-Y0,3335
+llm_kit/frontdoor/__init__.py,sha256=IuTWxMQ7oGCvkFLL0UKycGYCsxO0tgkwwl1JzLnhd7o,358
+llm_kit/frontdoor/__main__.py,sha256=DVaoKF89eJjH0ktT8s4I58zJ29Aak_M0lSsQESXheQM,83
+llm_kit/frontdoor/acceptance.py,sha256=xelSVFN9tveL0PhDXpcecwbkJb4psKeWdk9phZSq80g,18028
+llm_kit/frontdoor/server.py,sha256=owJjljR2E6boBYCl0L1X2lx6UZ7H-F2xVYm8eQS2bBY,23313
+llm_kit/jobs/__init__.py,sha256=_uESZeUbsoCZTajfeVEVtBCz-fzpgZ4Imx9ghx0_wk8,4711
+llm_kit/jobs/events.py,sha256=F5XoWT0QuzTvKshqitxnOXhUPBrdaeOjyPotwk6ZIIg,10223
+llm_kit/jobs/interrupts.py,sha256=-dUT7CRGQtv3MKL8EirNQb4BKYG0bkW1tU-xSna485c,16173
+llm_kit/jobs/model.py,sha256=_HWrEXbEWpUxIt-mVSGl0-SNGs_Be7-cOZgmxZLM1aQ,56681
+llm_kit/jobs/run.py,sha256=yil3seVUXVSjHaIqXD9UyPDDdLE7L8VetYBgXy3MvDA,76414
+llm_kit/jobs/select.py,sha256=D97hFsuEzF1eRDlQNCplGue9IHq2afbqbcahMMkrYxA,16007
+llm_kit/jobs/store.py,sha256=DaVGEvgBCfD8EW-Fnjpfz7FgLe0dyIGYKbHJlerwHn0,132782
+llm_kit/jobs/workspace.py,sha256=MCM46tGw7RopVc_NdE7n9ZGxLrT4WxYeQId_bealspg,40926
+llm_kit/pipeline/__init__.py,sha256=5I0NhAlQsWQtBj0NL1c_4BV0-V0SXq3nK6EdHHg0R40,68
+llm_kit/pipeline/analysis/__init__.py,sha256=WgXSm9OalsyFw0kJMfSNfY8nflRn2mK9kSDXZMxRPCc,122
+llm_kit/pipeline/analysis/audit/__init__.py,sha256=LwccmNovcVujDlT0fZtb0EXLLg-GyvxVGQoZnU2x2jg,2145
+llm_kit/pipeline/analysis/audit/auditor.py,sha256=Io7BtAs2wuiuj8exMTv_4AUwN3BOcOs_sZYk3Lyzxg0,8694
+llm_kit/pipeline/analysis/audit/reasoning_chain.py,sha256=oV-jTbQDXGGva4jkjZpnFrY8V7EqG34VcVLczYqnGek,8703
+llm_kit/pipeline/analysis/audit/report.py,sha256=o9rCO_vZAFM74u4AeIZpUZPhrn1cNRRbg_Kq3QLmFxk,5580
+llm_kit/pipeline/analysis/provenance/__init__.py,sha256=JEM6eq45XnvVM2W-KJhAe7DpKuZVl2m3NBirmRd_I6w,771
+llm_kit/pipeline/analysis/provenance/call_audit.py,sha256=DHpuf1jonb1KbYr6OcVrxbLN9bRL3Et4psf5bhwSvjE,7918
+llm_kit/pipeline/analysis/provenance/record.py,sha256=elhVDHDzAHC_ygLsk4JmQJ18jSxFgUQOX9T0fhlJQx4,9628
+llm_kit/pipeline/analysis/provenance/replay.py,sha256=TJBbpo247Sl7-PMnr4tS3GUOiV8NulJwOvktlLJA_dA,5951
+llm_kit/pipeline/analysis/provenance/snapshot.py,sha256=YjNh1ZyMmiAIN9lT_lAm4fIuiIVqUuktURvqZTkqu1E,6502
+llm_kit/pipeline/artifacts/__init__.py,sha256=mfPzph98umt6MI_2GREKg6r58y6ULf4t73QKyxSSevQ,143
+llm_kit/pipeline/artifacts/cli/__init__.py,sha256=qIQqJskY2BaH3jm4qbfl66in8N2YNMY4eBMwuaGIiDM,76
+llm_kit/pipeline/artifacts/cli/unsupported.py,sha256=r9YnTDy03lN7Lu3K6gzQXp3lX-7IlbqFWgkGXCVY_cg,6806
+llm_kit/pipeline/artifacts/deliver/__init__.py,sha256=A0s_1QRwUtKTrEl6px2dhCQXWo7U_NQDFMRdo8OIpKw,2047
+llm_kit/pipeline/artifacts/deliver/inplace.py,sha256=z_Un0i8Ya7RdfPjWuoKP75qGZwi7gIEplof0Qj6jXNY,20820
+llm_kit/pipeline/artifacts/deliver/projection.py,sha256=aR4yjmRzBJsQ3tqqBzFFPHxwHj1hpR3hCMb8Ql6TopM,6199
+llm_kit/pipeline/artifacts/freshness/__init__.py,sha256=QswlBBkH0EIU1zjQCOFOaW3Whb8qxVkWK_MyrHAlDFY,3403
+llm_kit/pipeline/artifacts/freshness/classify.py,sha256=uyp3FpWakT0qv_fhLW22h7FeP2OgbmtRMSw3bQSGUkI,5036
+llm_kit/pipeline/artifacts/freshness/ensure.py,sha256=rGha33ttL1uyngbl1GWG2Z6_omPuLYNHwbld2fIwuEg,5879
+llm_kit/pipeline/artifacts/freshness/hashing.py,sha256=niWM_3ltrABeXI1S6KR6qTT40AzvzRh3cOmEXwmTvYI,8881
+llm_kit/pipeline/artifacts/freshness/tier.py,sha256=pgv8hMlC0eSJoUswp9w3SSZck2OW0xcCExmK7fewPRE,2329
+llm_kit/pipeline/artifacts/providers/__init__.py,sha256=9rti1HyQ6csbJHw1TM8-nEIMGkIkNhW4gX16E3jxA-o,2573
+llm_kit/pipeline/artifacts/providers/assembly.py,sha256=9TTUXL12WMwuNX1e0DFiVwRJF-xGNTln6S5rduxdCW4,8268
+llm_kit/pipeline/artifacts/providers/registry.py,sha256=ApgL9FcoiWqJMXVRLTboM01MY0Y3yLA7rv1XFCZtP4M,7796
+llm_kit/pipeline/artifacts/roundtrip/__init__.py,sha256=DyFR5AWNUM6fFpWorhV1-gBmxC2MtWYDfUtilYLuY7w,1539
+llm_kit/pipeline/artifacts/roundtrip/questions.py,sha256=qGdr2ErRdwUq7KZC_FkA4o-7kyZo72qw6ewFGWF821c,5796
+llm_kit/pipeline/artifacts/roundtrip/returns.py,sha256=EtLwb1ghMxFUAq1LOKueqC2yTge90CGAud21koNCnYY,4705
+llm_kit/pipeline/artifacts/store/__init__.py,sha256=O9L1AzsJ6Mrpkj1JWBRXXAIrEvd1ib7kvwhfEwiHlLE,4297
+llm_kit/pipeline/artifacts/store/attributed.py,sha256=gSr6tDaPUcVSOkOj_TEt78T_m6plTfhaj8fmrGh7CL0,13313
+llm_kit/pipeline/artifacts/store/candidate.py,sha256=3lRMDoM35VKQMjPzMTnZD3wsN0x4cZwI0EV6C57N7Bg,18460
+llm_kit/pipeline/artifacts/store/intermediary.py,sha256=wejKLNxUM5KyP9QS2HPQMdaxX2CnhvTsQKLfvg9ZWVc,6566
+llm_kit/pipeline/artifacts/store/projection.py,sha256=540w0-GwpTObEc_7LZR2LirFc8HNTyVhYF48E1VOtBk,4573
+llm_kit/pipeline/artifacts/vcs/__init__.py,sha256=r3blDEk9dnzlvV-QPslhTD0xLqCOeOxoupyVx3A3lAY,1617
+llm_kit/pipeline/artifacts/vcs/git_vcs.py,sha256=Rh0yDtKahffDfTrhI7kduiJd7w0k0jp-JBZh0SJq2Ag,12096
+llm_kit/pipeline/artifacts/vcs/null_vcs.py,sha256=XBBIkOjDbJrH5w4kBLy7Cu79xZmg8uZcY3ShjqjWZ2g,755
+llm_kit/pipeline/core/__init__.py,sha256=r8M9We4OaJaVnLzC7jdZoXAPNHvR_0HGmEWBbiYYXes,2407
+llm_kit/pipeline/core/cell_policy.py,sha256=7Qr5X_YjHINb5E-D0Ffrddke02Z5TMMU0rI0BQ8p79s,3788
+llm_kit/pipeline/core/convergence.py,sha256=X7ByTtm-J66cGZyKB3CJeZ5WYqRGnQm6R4lZQZnNR0U,6319
+llm_kit/pipeline/core/convergence_loop.py,sha256=5gGStSQRtcoCmq8g--doLi5U06HkAVp19OgZTJFKf14,13222
+llm_kit/pipeline/core/gate.py,sha256=Tc7fNF4lQ1i6nwf2bRSaiZsV-jfNrzcCpTgwTSoK1qQ,1770
+llm_kit/pipeline/core/seed.py,sha256=EOcl1JGnlAWKrpc9Xky_VYSE6QAj4qq-RpUwJwt1Uoc,2547
+llm_kit/pipeline/core/single_pass.py,sha256=t7mN0NrqSOgEcNelP-lXhtePhKSzU4SnBsHeNL1YA2w,1704
+llm_kit/pipeline/core/stage.py,sha256=Zi2g7EYslA9EbDUon15mtwKWpsxeel40kAB0m3y7fLc,1343
+llm_kit/pipeline/core/vcs_seam.py,sha256=qdfZBO3vPhosdQBCqRpM1iQtfLFT5fnX6oRx0tCMCpo,809
+llm_kit/pipeline/core/workunit.py,sha256=YSYbpsltNM50FtEWcgbKCy8-3GClxNbPSg4SKlxSViA,5624
+llm_kit/pipeline/core/validate/__init__.py,sha256=s7CAc9MVoe3jPjQxc9oMeLWuw3H7wL1vznRyYnVUAo8,3003
+llm_kit/pipeline/core/validate/contract.py,sha256=w8d7p_CY72BZlJc8ffbFygrU2GEwte2UjiPEQ0NiqsQ,5866
+llm_kit/pipeline/core/validate/floor_guard.py,sha256=lpaLrZvGtRXPsC70UVxUA3GiL-Y45MTGUv0Z7zvf_Bg,4550
+llm_kit/pipeline/core/validate/riders.py,sha256=iH7-qbZX1PlF8tFS4qsEsn3lb6DRsj3BpZ2Re5L_x_E,4398
+llm_kit/pipeline/execution/__init__.py,sha256=Yj7FqxQ2FK3lxX7Y0vj6sZx438-hoQHqX0dPbQ7L9hU,6810
+llm_kit/pipeline/execution/adapter.py,sha256=ceutnKmf6ivsJ_k5of2oTP-RkZLTIetXlrqXPrhsPwQ,36625
+llm_kit/pipeline/execution/controller.py,sha256=qPwz8icgCL_94gDBRTcgajLUulVVL5X39JOH_kVxDuU,36465
+llm_kit/pipeline/execution/deadlines.py,sha256=bHsnspUpOUBUeJRuDnSW_b0NOiFFDVu5Bbz5kercsLo,10559
+llm_kit/pipeline/execution/events.py,sha256=I63MzPY9rpLHq8ejIhWIs6MFkY9DBE9ogys7UxXFuDM,17955
+llm_kit/pipeline/execution/failure_cache.py,sha256=4pqSzBYPB0gIR_GhwLnOO2Fc72EVcWThHFXLXlNRs30,6849
+llm_kit/pipeline/execution/interrupts.py,sha256=cPAinyW-OkrUN8TsqVpNxJXr-9VIHXNQ7_NbFi1HmQM,17101
+llm_kit/pipeline/execution/model.py,sha256=4zSdrxNVQIKAgPaK2BjquyeAXMrVHOJAt2fxYKKuoU4,24824
+llm_kit/pipeline/execution/parallel_graph.py,sha256=5PxndyUoy6LsEZxYgmXJC3kTDLblUKCBYCy80OOITXU,4450
+llm_kit/pipeline/execution/protocol.py,sha256=jTyRoS_p2RMjH2lpJrOrr8_Bjhjffiw-a1NlBOn0dXg,32270
+llm_kit/pipeline/execution/scheduler.py,sha256=3qT6m1k1qRnKHBGiop883cjdmTKIymX-nsQgRuVYWUg,13871
+llm_kit/pipeline/execution/status.py,sha256=ikHDDTfWtYojiZrGcoAjLYA3YlQ9GpKBUm4Tu-xEsrA,14433
+llm_kit/pipeline/execution/store.py,sha256=jWC6PbEtNDE_bwJVMsep4h8gjid-G3vezFI_ib7uApQ,85030
+llm_kit/pipeline/execution/wave.py,sha256=KTqYlr1ZIWYkD8X6aw0ITaISxjNK7WndVByRnl0JtVk,27092
+llm_kit/pipeline/execution/workerpack.py,sha256=xtH7O_6OW7WUauNi4jXyfC6As3CZFjiOJFzncBLVdUc,43736
+llm_kit/pipeline/execution/drivers/__init__.py,sha256=lGi2Nsntms8Zbt2_a2f8L7ZDR0qP01H183wUr7AQRyg,2071
+llm_kit/pipeline/execution/drivers/claude_bg.py,sha256=I4Vf43mlfvQa9kdnCHNrRhMTPyFWR7f_AO2wxEmt6ls,117172
+llm_kit/pipeline/execution/drivers/inline.py,sha256=Bx3Jlz4gxtsOj0M4OnFLrimjZ3tV3eBxkDb8sIy_gVk,18134
+llm_kit/pipeline/runtime/__init__.py,sha256=4mkY5ixfJO2p-rs3ijYoHYyNDIRnnAw3XrT_JJ5jxDQ,10217
+llm_kit/pipeline/runtime/backends.py,sha256=dU8PWT38vaOzT3dOI8_X719IG1ZqKukr85fksw4BsnE,57707
+llm_kit/pipeline/runtime/budget.py,sha256=oSiieSPVwyEWQBxndP-MEpB8ZaS9JmG0-DusYJnm3Mc,7136
+llm_kit/pipeline/runtime/gate.py,sha256=KGj_bCLFsngSHcDlfN-gJ9zgxGrpB1BWOoii-LSvDUE,9191
+llm_kit/pipeline/runtime/platform.py,sha256=eYOMoQ9ErsTSXIa04OmYsf5eBmb-NwXN2GmN_6HXjH0,108486
+llm_kit/pipeline/runtime/spend_ledger.py,sha256=nRqR3JiHJKi9-BO0IdR5dTwj0k3cKez4Qq9JFDsgX9o,61312
+llm_kit/pipeline/runtime/yaml_extract.py,sha256=GQ0_T9HYu0d7myirLOq_GTJqYJ9DOa25lTKXeI_HplI,4588
+llm_kit/registry/__init__.py,sha256=db5pg84htFTpmEn6IztpTbjPW7u_EshwVEKmRNl76NQ,467
+llm_kit/registry/api_key.py,sha256=RgPWFbeF7lP0a769lGRT2HApA2QGntBTe6zE2RtUZ2g,11701
+llm_kit/registry/consent.py,sha256=w9uMVJaQSmsWH0EduEk0651gtxgYrvSAoukCcVyVLX8,4457
+llm_kit/registry/conserve.py,sha256=5Lwbyvy2KYCrPsl6-8uDYtfhw1qLwehexzfwzYMAaiY,7916
+llm_kit/registry/constants.py,sha256=eJ2nOPnBI_bA9QBYS7QYqDm39uteac7roQgQXcFT7fY,4670
+llm_kit/registry/cost.py,sha256=6sxvGE4NzC9TRkMqCYSYRWxKt2AXDWSUd_MUbuXxw1E,5871
+llm_kit/registry/declaration_syntax.py,sha256=A9NGy2e0k5qZEewNs_OJX3mAeJSHBhdBGI7bvLdheik,2597
+llm_kit/registry/effort.py,sha256=TSMiosIBJz7kiSW0nnKCly7C4EqQ9WONPExrSlmZwbk,14285
+llm_kit/registry/env_file.py,sha256=mhShwePAwTxzqQdIZ8vW1n1OYGf1RZWJtXotF24fz5E,5171
+llm_kit/registry/model_endpoints.py,sha256=FoVe9hBtYgQXFmZI2h_qX_I9Ew-kHAGndcjKAg1KX9c,31488
+llm_kit/registry/models.py,sha256=KRXS0itS55oZ1ji-oMx4z_1SWAqjhudkzg0WVqUViAg,40274
+llm_kit/scaffold/__init__.py,sha256=EYpSTYROuPE4uESncaWgKPbUMXsUj4wvSq20uUJ2kEs,5782
+llm_kit/schema/__init__.py,sha256=JSPwzlWJadhXupSI68JBwd6tbRE8BuQX0D0hYGtrugc,176
+llm_kit/schema/json_repair.py,sha256=FZMCOxiwCEbbT1C8sKNJPL5iKk4mSd6Z7QE33lNFckg,22109
+llm_kit/schema/json_schema.py,sha256=tz9j1ciXRTxDtWHh66ocz1p1R3ggECnKhq9ZL1TQ7ZI,16419
+llm_kit/storage/__init__.py,sha256=8WRsdaV_5MiCdpjIt4QBgHv8eflpfKfGO1m7Y_tJsXk,834
+llm_kit/storage/atomic_json.py,sha256=_hc_dE42WHoVyfpbLMxIuzxfwKicRW0hWCdcAHgjgEI,2016
+llm_kit/storage/connection.py,sha256=YU25NO5GNjHvgtj5yZkCSGS7FVM_u-6yeZcNBfH83vY,6735
+llm_kit/storage/network.py,sha256=cDf3o94icw4FEK21eVto3P5pMMJBjrjm603GjiMEYUs,1882
+llm_kit/storage/schema_version.py,sha256=P-P001bgEQkoKn88YUJriC_gJ4zQzXpTQkhfZjuxw-A,1258
+llm_kit/storage/transaction.py,sha256=b3OMzIIdfAvoE_ojyZPD9rKiYno5g-zRRBArIhh2rKg,2477
+llm_kit/_deployment.py,sha256=3TBAA-JLhgrIaTQexElxia_LIO7OgmsEgOCzLV5ZkKA,303
+katsoft_llm_kit-1.0.0.dist-info/METADATA,sha256=kUmFMMaCvluHC8AJ0PwViwXiW3y93AudxI8h5WjwJR8,2262
+katsoft_llm_kit-1.0.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+katsoft_llm_kit-1.0.0.dist-info/entry_points.txt,sha256=2oTHYfDc81QhYEqogzPEjsUE6WrJN5WJj50Mce05muc,45
+katsoft_llm_kit-1.0.0.dist-info/licenses/LICENSE,sha256=Sz-E7czerfZKqa2AwHbTimnPuV3RgQ4O6ebbGNwM5K4,1066
+katsoft_llm_kit-1.0.0.dist-info/RECORD,,

katsoft_llm_kit-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

katsoft_llm_kit-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+llm-kit = llm_kit.cli:main

katsoft_llm_kit-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

llm_kit/_deployment.py

@@ -0,0 +1,7 @@
+"""Release identity written by packages/_build/hatch_build.py. Do not edit."""
+MODE = "package"
+DIST = 'katsoft-llm-kit'
+VERSION = '1.0.0'
+TAG = 'katsoft-llm-kit-v1.0.0'
+COMMIT = '5f44fbbd87c433b740dcfd2f07efc23c4a61f731'
+TAG_URL = 'https://github.com/kitaekatt/plugins-kit/tree/katsoft-llm-kit-v1.0.0'

llm_kit/_runtime.py

@@ -0,0 +1,252 @@
+"""Which deployment this ``llm_kit`` runs in, and the seams that depend on it.
+
+Two deployments exist and they must never be mixed in one environment:
+
+``legacy``
+    The plugin's copy. Bootstrap links ``lib/llm_kit`` onto the plugin venv
+    through a ``.pth`` file, ``bootstrap_lib`` is linked the same way, and the
+    shared contracts (``execution_event``, ``interrupt_contract``,
+    ``model_declaration``) are read from ``bootstrap_lib``. The committed
+    ``llm_kit/_deployment.py`` says ``MODE = "legacy"``.
+
+``package``
+    The ``katsoft-llm-kit`` wheel. It carries a build-hook-written
+    ``llm_kit/_deployment.py`` (``MODE = "package"``, ``DIST``, ``VERSION``,
+    ``TAG``, ``COMMIT``, ``TAG_URL``), depends on ``katsoft-contracts`` and
+    never meets ``bootstrap_lib``.
+
+``mode()`` decides once per process and refuses an environment whose identity
+cannot be established. Nothing here reads the network or the clock, and nothing
+is repaired: an ambiguous environment raises and says what to separate.
+
+Standard library only; imports no other ``llm_kit`` module besides the marker.
+"""
+from __future__ import annotations
+
+import base64
+import hashlib
+import importlib
+import importlib.metadata as metadata
+import json
+import os
+import re
+import sys
+from importlib.machinery import SourceFileLoader
+from typing import Any, Optional
+
+#: The distribution that ships the package deployment.
+DIST = "katsoft-llm-kit"
+#: The distribution and import package that carry the shared contracts.
+CONTRACTS_DIST = "katsoft-contracts"
+CONTRACTS_PACKAGE = "katsoft_contracts"
+#: The only contracts the library routes; everything else from ``bootstrap_lib``
+#: is a legacy-only feature (``require_legacy``).
+ROUTED_CONTRACTS = ("execution_event", "interrupt_contract", "model_declaration")
+
+LEGACY = "legacy"
+PACKAGE = "package"
+_MODES = (LEGACY, PACKAGE)
+_MARKER_MEMBER = "llm_kit/_deployment.py"
+
+
+class RuntimeIdentityError(RuntimeError):
+    """The deployment of this ``llm_kit`` cannot be established or is ambiguous."""
+
+
+class UnsupportedLayout(RuntimeError):
+    """``llm_kit`` is loaded in a layout the runtime-mode check cannot verify.
+
+    Frozen interpreters, zip imports, bytecode-only files and editable
+    installs have no on-disk file the installed metadata can be checked
+    against, so they are refused rather than guessed at.
+    """
+
+
+class ContractsMissing(ImportError):
+    """Package mode needs ``katsoft-contracts``, which is not importable."""
+
+
+class UnsupportedInPackageMode(RuntimeError):
+    """A feature that needs the marketplace's ``bootstrap_lib`` was used in package mode."""
+
+    def __init__(self, feature: str) -> None:
+        self.feature = feature
+        super().__init__(
+            f"{feature} needs the plugin marketplace's bootstrap_lib, which the "
+            f"{DIST} package does not provide; use the llm-kit plugin for it"
+        )
+
+
+_MODE: Optional[str] = None
+
+
+def _normalize(name: str) -> str:
+    return re.sub(r"[-_.]+", "-", name).lower()
+
+
+def _real(path: Any) -> str:
+    return os.path.normcase(os.path.realpath(os.fspath(path)))
+
+
+def mode() -> str:
+    """``"legacy"`` or ``"package"``; decided once per process, cached on success."""
+    global _MODE
+    if _MODE is None:
+        _MODE = _identify()
+    return _MODE
+
+
+def _identify() -> str:
+    # (1) The marker.
+    try:
+        from llm_kit import _deployment  # noqa: PLC0415
+    except ImportError as exc:
+        raise RuntimeIdentityError(
+            "llm_kit/_deployment.py is missing, so the deployment of this llm_kit "
+            "cannot be identified"
+        ) from exc
+    declared = getattr(_deployment, "MODE", None)
+    if declared not in _MODES:
+        raise RuntimeIdentityError(
+            f"llm_kit/_deployment.py states MODE = {declared!r}; expected one of {_MODES}"
+        )
+    # (2) The layout.
+    _check_layout(_deployment)
+    named = _named_distributions()
+    if declared == LEGACY:
+        # (3) A linked plugin copy beside an installed package: two llm_kit.
+        if named:
+            raise RuntimeIdentityError(
+                "this environment holds both the plugin's llm_kit (bootstrap "
+                f"shared-lib .pth) and the {DIST} package; use separate "
+                "environments -- the plugin venv for the plugin, a consumer venv "
+                "without the bootstrap llm_kit link for the package"
+            )
+        return LEGACY
+    # (4) The package.
+    _check_package(_deployment, named)
+    return PACKAGE
+
+
+def _check_layout(deployment: Any) -> None:
+    if getattr(sys, "frozen", False):
+        raise UnsupportedLayout("llm_kit does not support a frozen interpreter")
+    spec = getattr(deployment, "__spec__", None)
+    if spec is None or type(spec.loader) is not SourceFileLoader:
+        raise UnsupportedLayout(
+            "llm_kit must be loaded from source files on disk; this layout "
+            f"(loader {type(getattr(spec, 'loader', None)).__name__}) is not supported"
+        )
+    path = getattr(deployment, "__file__", None)
+    if not path or not os.path.isfile(path):
+        raise UnsupportedLayout("llm_kit/_deployment.py is not a file on disk")
+
+
+def _named_distributions() -> list:
+    """Every distinct installed distribution named ``DIST``.
+
+    One physical location is one distribution, however many ``sys.path``
+    entries lead to it; two locations are a duplicate.
+    """
+    wanted = _normalize(DIST)
+    found: dict[str, Any] = {}
+    for dist in metadata.distributions():
+        name = dist.metadata["Name"]
+        if name and _normalize(name) == wanted:
+            found.setdefault(_real(dist.locate_file("")), dist)
+    return list(found.values())
+
+
+def _check_package(deployment: Any, named: list) -> None:
+    if not named:
+        raise RuntimeIdentityError(
+            f"llm_kit/_deployment.py states MODE = 'package' but no {DIST} "
+            "distribution is installed"
+        )
+    if len(named) > 1:
+        where = ", ".join(sorted(_real(d.locate_file("")) for d in named))
+        raise RuntimeIdentityError(f"{DIST} is installed more than once ({where})")
+    dist = named[0]
+    direct = dist.read_text("direct_url.json")
+    if direct:
+        try:
+            editable = bool(json.loads(direct).get("dir_info", {}).get("editable"))
+        except (ValueError, AttributeError) as exc:
+            raise RuntimeIdentityError(f"{DIST} has an unreadable direct_url.json") from exc
+        if editable:
+            raise UnsupportedLayout(f"{DIST} is an editable install; install the built wheel")
+    loaded = os.fspath(deployment.__file__)
+    entries = [f for f in (dist.files or ()) if str(f).replace("\\", "/") == _MARKER_MEMBER]
+    if len(entries) != 1 or entries[0].hash is None or entries[0].hash.mode != "sha256":
+        raise RuntimeIdentityError(
+            f"the RECORD of {DIST} does not list {_MARKER_MEMBER} with a sha256"
+        )
+    with open(loaded, "rb") as handle:
+        digest = base64.urlsafe_b64encode(hashlib.sha256(handle.read()).digest()).rstrip(b"=").decode()
+    if digest != entries[0].hash.value:
+        raise RuntimeIdentityError(
+            f"{_MARKER_MEMBER} does not match the RECORD of {DIST}; the package was modified"
+        )
+    if _real(dist.locate_file(entries[0])) != _real(loaded):
+        raise RuntimeIdentityError(
+            f"the llm_kit loaded from {loaded} is not the copy {DIST} installed"
+        )
+    stated = (getattr(deployment, "DIST", None), getattr(deployment, "VERSION", None))
+    if stated != (DIST, dist.version):
+        raise RuntimeIdentityError(
+            f"llm_kit/_deployment.py states {stated[0]!r} {stated[1]!r} but the "
+            f"installed distribution is {DIST!r} {dist.version!r}"
+        )
+    for other in metadata.distributions():
+        if any(other is d or _real(other.locate_file("")) == _real(d.locate_file("")) for d in named):
+            continue
+        if any(str(f).replace("\\", "/").startswith("llm_kit/") for f in (other.files or ())):
+            raise RuntimeIdentityError(
+                f"{other.metadata['Name']!r} also provides llm_kit files; "
+                f"{DIST} must be the only provider of the llm_kit package"
+            )
+
+
+def load(name: str, error: Optional[type] = None) -> Any:
+    """Import the routed contract ``name`` from ``katsoft_contracts`` (package mode).
+
+    Only a ``ModuleNotFoundError`` that names ``katsoft_contracts`` or the
+    routed submodule means the contracts distribution is missing; it becomes
+    :class:`ContractsMissing`, or ``error`` (the calling product's own
+    ``ImportError`` subclass) worded the same. Absent (``katsoft_contracts``
+    does not import: install) and too old (it imports but lacks the routed
+    module: upgrade) read differently. Every other ``ImportError``
+    propagates unchanged: a broken contracts install must not read as an absent
+    one.
+    """
+    if name not in ROUTED_CONTRACTS:
+        raise ValueError(f"{name!r} is not a routed contract; routed: {ROUTED_CONTRACTS}")
+    if mode() != PACKAGE:
+        raise RuntimeIdentityError(f"load({name!r}) is a package-mode seam; this llm_kit is {mode()}")
+    qualified = f"{CONTRACTS_PACKAGE}.{name}"
+    try:
+        return importlib.import_module(qualified)
+    except ModuleNotFoundError as exc:
+        if exc.name not in (CONTRACTS_PACKAGE, qualified):
+            raise
+        if exc.name == qualified:
+            # The package imports but lacks the routed module: too old (or
+            # stale), a different remedy from an absent install.
+            missing = ContractsMissing(
+                f"{CONTRACTS_DIST} is installed but has no {name}; upgrade "
+                f"{CONTRACTS_DIST} ({DIST} requires >=1.0,<2)"
+            )
+        else:
+            missing = ContractsMissing(
+                f"{qualified} is not importable: install {CONTRACTS_DIST} "
+                f"(the {DIST} package depends on it)"
+            )
+        if error is None:
+            raise missing from exc
+        raise error(str(missing)) from exc
+
+
+def require_legacy(feature: str) -> None:
+    """Refuse ``feature`` in package mode, before any ``bootstrap_lib`` import."""
+    if mode() == PACKAGE:
+        raise UnsupportedInPackageMode(feature)

llm_kit/adapters/__init__.py

@@ -0,0 +1,18 @@
+"""llm_kit.adapters: concrete integrations behind the completion contracts.
+
+OpenAI-compatible, Claude, Codex and OpenCode backends; the CLI streaming
+runner; the harness command adapters; the llama-swap swapper client and its
+process layer; the raw Claude/Codex usage-source readers; the account and
+endpoint probes; endpoint profiles; and the filled adapter capability tables.
+
+Depends only on ``llm_kit.completion`` and ``llm_kit.registry``. Pacing policy,
+backend factories and reachability live in ``llm_kit.dispatch``.
+
+No root re-exports; import from the owning module (``llm_kit.adapters.account``,
+``llm_kit.adapters.backends``, ``llm_kit.adapters.capabilities``,
+``llm_kit.adapters.claude_runner``, ``llm_kit.adapters.client``,
+``llm_kit.adapters.codex_backend``, ``llm_kit.adapters.endpoint_profile``,
+``llm_kit.adapters.harness_adapters``, ``llm_kit.adapters.opencode_backend``,
+``llm_kit.adapters.swapper``, ``llm_kit.adapters.swapper_acceptance``,
+``llm_kit.adapters.usage_sources``).
+"""

llm_kit/adapters/_swapper_errors.py

@@ -0,0 +1,30 @@
+"""Error vocabulary shared by the swapper service and its process layer.
+
+``swapper`` (the service) and ``_swapper_process`` (the process primitive)
+both raise these. They live in this leaf so the process layer imports no
+service module; ``swapper`` re-exports every name, so
+``swapper.ProcessNotFound`` is this very class. ``exit_code`` is the CLI
+contract, so the facade maps without logic.
+"""
+
+from __future__ import annotations
+
+EXIT_FAILURE = 1
+EXIT_USAGE = 2
+EXIT_INDETERMINATE = 5
+
+
+class SwapperError(Exception):
+    """Base error. Operation failure unless a subclass says otherwise."""
+
+    exit_code = EXIT_FAILURE
+
+
+class ProcessNotFound(SwapperError):
+    """A PID does not exist, or was reused (different create_time)."""
+
+
+class InspectionIndeterminate(SwapperError):
+    """The process table could not be read well enough to decide."""
+
+    exit_code = EXIT_INDETERMINATE