ko-tasks-sdk 1.0.0__py3-none-any.whl

ko_tasks_sdk-1.0.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.5
+Name: ko-tasks-sdk
+Version: 1.0.0
+Summary: Python SDK for Komus Tasks — define, test, and deploy task workflows
+Project-URL: Documentation, https://github.com/Komus-ai/ko-tasks-platform#readme
+Project-URL: Repository, https://github.com/Komus-ai/ko-tasks-platform
+Project-URL: Issues, https://github.com/Komus-ai/ko-tasks-platform/issues
+Project-URL: Changelog, https://github.com/Komus-ai/ko-tasks-platform/blob/main/CHANGELOG.md
+Author-email: "Komus.ai" <codir@komus.ai>
+License: MIT
+Keywords: async,automation,framework,sdk,task,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: ko-observability<0.3,>=0.2.0
+Requires-Dist: opentelemetry-api>=1.27.0
+Requires-Dist: opentelemetry-sdk>=1.27.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=14.0.0
+Requires-Dist: structlog>=24.4.0
+Provides-Extra: agent
+Requires-Dist: websockets>=12; extra == 'agent'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Komus Tasks SDK (Python)
+
+Python SDK for building, testing, and deploying tasks with the Komus Tasks.
+
+## Installation
+
+First public PyPI release: **1.0.0** (`ko-tasks` CLI and bundled agent skills).
+
+```bash
+pip install ko-tasks-sdk
+```
+
+## Quick Start
+
+### 1. Create a new task
+
+```bash
+ko-tasks init my-task --runtime python
+cd my-task
+```
+
+### 2. Edit `task.py`
+
+```python
+async def run(context):
+    context.report_progress(0.0, "Starting...")
+
+    inputs = context.get_inputs()
+    # ... your logic ...
+
+    context.report_progress(1.0, "Done")
+    return [{"kind": "text", "text": "Result"}]
+```
+
+### 3. Run locally
+
+```bash
+ko-tasks run
+```
+
+### 4. Deploy
+
+```bash
+ko-tasks deploy --server https://tasks.example.com --admin-key YOUR_ADMIN_KEY
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `ko-tasks init <name>` | Scaffold a new task project |
+| `ko-tasks run` | Start a local dev server |
+| `ko-tasks package --task-dir . -o task.zip` | Package task for deployment |
+| `ko-tasks deploy -s URL --admin-key KEY` | Deploy to remote server |
+| `ko-tasks status <thread_id> -s URL --api-key KEY` | Check thread status |
+| `ko-tasks list -s URL --admin-key KEY` | List deployed tasks |
+
+## TaskContext API
+
+The `context` object passed to your task function provides:
+
+### Inputs & Outputs
+- `context.get_inputs()` — Returns list of input artifacts
+- Return a list of output artifacts from your function
+
+### Progress Reporting
+- `context.report_progress(fraction, message)` — Report progress (0.0 to 1.0)
+
+### Cooperative Control
+- `context.check_pause()` — Blocks if task is paused, raises if cancelled
+- `context.is_paused()` — Returns True if pause requested
+- `context.is_cancelled()` — Returns True if cancellation requested
+
+### Artifacts
+- `context.store_artifact(data, filename, media_type)` — Store output artifact
+- `context.get_artifact(artifact_id)` — Retrieve an artifact
+
+### Configuration
+- `context.get_config(key)` — Get a configuration/credential value
+
+## Task Definition (task.yaml)
+
+```yaml
+name: my-task
+version: 1.0.0
+description: "What the task does"
+entry_point: task:run
+runtime: python                   # python | node
+
+input_schemas:
+  - ref: input_data
+    kind: text
+    required: true
+    description: "Input description"
+
+output_schemas:
+  - kind: file
+    media_type: application/pdf
+    description: "Output description"
+
+requirements:
+  - name: API_KEY
+    required: true
+    description: "External API key"
+```
+
+## Development
+
+```bash
+# Clone the monorepo
+git clone https://github.com/Komus-ai/ko-tasks-platform.git
+cd ko-tasks-platform
+
+# Install in development mode
+uv sync
+
+# Run SDK tests
+uv run --package ko-tasks-sdk pytest packages/sdk-python/tests/ -v
+```
+
+## License
+
+MIT

ko_tasks_sdk-1.0.0.dist-info/RECORD

@@ -0,0 +1,175 @@
+komus_tasks/__init__.py,sha256=nVJ4KQHjFNLskPYURDEMizJjWKpbyBlcT_zy-TAC754,468
+komus_tasks/context.py,sha256=AGF2NnDMaRsEDCkyFJj651ZIXemJoZdv8khFiEnCwYI,15909
+komus_tasks/decorators.py,sha256=JZy7FtzN1wLFwoadb4OLCE8zNOAO_vjAG2jETx9c528,4394
+komus_tasks/errors.py,sha256=ao23zUruWHsq2LYQm5oUcY-9bAKk_Ou5J3uFC7-jVjk,2365
+komus_tasks/exceptions.py,sha256=qVQO9oSNoLqYG_98jIykYKlnMWlP_P0nYFTRdqXG2xQ,355
+komus_tasks/logging.py,sha256=jOZqBMTRyOCIX0hq9lts9GJTWWHngiB-GSwOXWIJ7Cw,7904
+komus_tasks/observability.py,sha256=psUa-WSmlGxrIBaLylABYf6C74bNu_KlcnFfYt0EMxg,3408
+komus_tasks/observability_otlp.py,sha256=jW47LLK1uqlneO40ATLv4bi9MjLQqvy36Xd5vNMh21A,320
+komus_tasks/thread_state.py,sha256=lvoFWz4tvAsZMXh8yURpaI7N-0ZkANEt6F9qQQaA_OM,358
+komus_tasks/version.py,sha256=OXvkvoaJ4cWvUDpWGguabuiNCbMao7L5e2RRTen_Dzw,1308
+komus_tasks/agent/__init__.py,sha256=sCwg9HeQPpLTQz_leLhkP9TA8BvFVB_7KE91vRWUReg,979
+komus_tasks/agent/__main__.py,sha256=lAmzNsmigdC4tdJO1VoE-9WBjjxxGfPvAo4aureH9O4,3493
+komus_tasks/agent/client.py,sha256=qbTSkeEoXVUdpkORzS_lYExfdLVeGqlhlevgp3vtO5M,16122
+komus_tasks/agent/provisioner.py,sha256=hV4M3lyeddfqqToAeuTRCUzirdiCCZJZC40_QtC-GA8,9286
+komus_tasks/cli/__init__.py,sha256=t0aIoPI0cX9auV9pcmz-sbjdb3NlgVjzSM-x0DnJmZg,318
+komus_tasks/cli/__main__.py,sha256=MUXIBgZ0mD7nNsmDrTj-Sv02mZ9qcTQnKwgwEd1sMgk,113
+komus_tasks/cli/app.py,sha256=qvUkgvifScfKi3xaBvmZH157rtCsWBP0dPTRApXS3xE,4944
+komus_tasks/cli/schema.py,sha256=VDRv0MhC4um07TuioD0d618PwAIMCRpFq17mMPyQs0k,1853
+komus_tasks/cli/ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+komus_tasks/cli/ai/llm.py,sha256=ylKI9UGFdizT1IU9rcQ0p0_LorUTdD-Hom1rUoXX85w,8635
+komus_tasks/cli/ai/prompts/system_prompt.md,sha256=HpAPd-id1XaM2WG_CpGhHXEBy96bbMbu4vo1bjJKmn4,1503
+komus_tasks/cli/commands/__init__.py,sha256=T_lLMCQAwgYrcFUGZYzZkzgv-_6x6E5xsapze882NzU,1229
+komus_tasks/cli/commands/activate.py,sha256=ZQAUmHNAKi4GG0TaM-u99rldM9R9uMcEDMnHNtP4rns,2273
+komus_tasks/cli/commands/agents.py,sha256=yWOWBW66tTQRjmq6pARbADfEJJ_-eGLNAgkCmE_WIVg,3566
+komus_tasks/cli/commands/artifacts.py,sha256=ov1gEUaXlIoExOl59Nm4YPnpJvCmlAGGE96Rsb_eGiY,8002
+komus_tasks/cli/commands/completion.py,sha256=7PjmHwtfYjWw9Mu0Ds5akb6_e9442mLBJlKMdH8q1gA,1194
+komus_tasks/cli/commands/config.py,sha256=XfDAa80D_RbZZp66h-muXgMwJUynLLGWqCKzeebzhh0,6429
+komus_tasks/cli/commands/config_remote.py,sha256=aEbv8evwTm3hmePnSVSuEpOZLCf582NrFeZrJt0uT4s,7538
+komus_tasks/cli/commands/credentials.py,sha256=8UtylbnizFFGlg2OXE7U3Wv7KN3E7VY0qeq0bqimEMs,7206
+komus_tasks/cli/commands/deactivate.py,sha256=2LpZh_SRgvvS866I6hjQUNM14BSHCMBS9-6GdZx_uis,1819
+komus_tasks/cli/commands/delete.py,sha256=i-YdhLPBWC9l-MiLNFaMybUgRNn0b1kxL5c-4V7tHTI,1882
+komus_tasks/cli/commands/deploy.py,sha256=toYSIl4kBFYHm4BvsX5lTKslZ4OlszES5DVXfUp0_Vg,5038
+komus_tasks/cli/commands/download.py,sha256=3tOSqoRPKIKkEHuyjiBGcF6B07wGY3_wYnp5ofNLG8A,2006
+komus_tasks/cli/commands/environments.py,sha256=A2OZRNJuzlvfYBViuzULBT1BdeRl_VAvxcuWcQk1L1g,11118
+komus_tasks/cli/commands/files.py,sha256=U_HmD7rmTVCZelDs9x0P6ypOF3EEdtAhKlzeCmdkbp8,3743
+komus_tasks/cli/commands/generate.py,sha256=8A_f5fjDvaAyiX0wP3GEndnzbyYZTXlJb9UR9C9NSZ8,21343
+komus_tasks/cli/commands/init.py,sha256=hIDEaCK0Dqp_gZEBlhjeRuuxrAH3LqKdg6LgpMJcNA8,3649
+komus_tasks/cli/commands/list.py,sha256=4RxqECDAa_fvXnIvnrAxQqDF-eJ_fe_MiTF483coteY,1637
+komus_tasks/cli/commands/local.py,sha256=thE9lm_84BQJlPLGY6z1Jkaa-BSLO2g9kqyy13CSdIQ,2853
+komus_tasks/cli/commands/logs.py,sha256=nQwvUW3uzpz47cv7PPFBZctmoNmR-d3P8T656XDdM2o,2834
+komus_tasks/cli/commands/long_running.py,sha256=tRfaFEX6xjnmPNOmHB6_3z5bpLok7Cb0lyb3kT1tjU0,3592
+komus_tasks/cli/commands/package.py,sha256=hFuDJjqZej9iwwb6FXgMe_YoyRu7H3AqFmW3rUkcwFQ,1524
+komus_tasks/cli/commands/profile.py,sha256=Vj1QcZ0QcFFGtaD5UYAC3JOyFtejfkzRnQ1gffF-rd8,2564
+komus_tasks/cli/commands/promote.py,sha256=vgm0CJ_UwYLK-pAjVmz1SpMd_BkdTKfZymHTSwkGU-Y,2216
+komus_tasks/cli/commands/rollback.py,sha256=M3dug6oe_Pdr08CuwLBxh31sT4f8cPlWFwXj9RSt9zc,1756
+komus_tasks/cli/commands/run.py,sha256=xc0TLeN_pjyu1l7RxJt8KUM776VWeAYHDorB0BFhMS4,8307
+komus_tasks/cli/commands/schedules.py,sha256=-oRvtXGCCaAf0WVHPIqHBCctoULM9SrnhGXKZMFO58I,10518
+komus_tasks/cli/commands/schema_cmd.py,sha256=LQ-rAHmyhxqa_GLkEGSVUUvtA1gttzZjaSCe4Bl3iz4,841
+komus_tasks/cli/commands/skills.py,sha256=iAAyfNyVk_I95MxL0if_4Xa3PzeRvDoJ3_I4WBawylg,10166
+komus_tasks/cli/commands/status.py,sha256=S2wpWqKY7rKn6zH21IbYlGbtGqnLU0zsrq_eug1Ual0,1500
+komus_tasks/cli/commands/threads.py,sha256=-PF-sKhbMTcnuvOaosgnD6PMIIMQTKFhfO1u_GTmg88,8458
+komus_tasks/cli/commands/webhooks.py,sha256=p_yiUdvfkNlwz1SGlcQWp49ouL6WepVHnkadL5CQlPE,12964
+komus_tasks/cli/permissions/agents.md,sha256=CMT6R1fZjqXQ8m0902GJAtMPxw_z05J-0vOXID3-H6s,837
+komus_tasks/cli/permissions/claude.md,sha256=EBL2OdD3diSTTIZg0wOtrTeW49gUz2-0NVOzFwvFzpc,1138
+komus_tasks/cli/permissions/codex.md,sha256=MQywokQ7Lz0KqtWpJN5QO_qlsr0L8y27vnX7Gr6p4os,914
+komus_tasks/cli/permissions/cursor.md,sha256=23xbVImLmB7SO30LOX3xPWjbkmEQ0u-UnIT0Xmheg2A,836
+komus_tasks/cli/runtime/__init__.py,sha256=DTRbwb2o1gpjUL-LW5Ob_T7og9ZoioJB84b9NdlSuf8,69
+komus_tasks/cli/runtime/context.py,sha256=h0HQjskNURL65BIXCFN-E5lujjsV1OK_8fmYqSYWIHQ,3108
+komus_tasks/cli/runtime/discovery.py,sha256=MEdZOuppMKGX0pJL4x4DruIfcNxJoE9JfzZMDV0tB-U,1710
+komus_tasks/cli/runtime/errors.py,sha256=hL53JprTBxwSlqQub39YoGI6O3Gv-d6nkRREK7am5lM,1504
+komus_tasks/cli/runtime/http.py,sha256=SB7zgn5WQXsU8dTpvYYVIvfeoJdkSWEXt0Jfx_BDsec,8081
+komus_tasks/cli/runtime/inputs.py,sha256=ZRACtU3pWw9JkGN40hr2k2w61CYiNdaxZeWyaBbXQNc,1864
+komus_tasks/cli/runtime/metadata.py,sha256=8n0FqPXk74TZeiasowsLsRY6ACVc13OSL_0UNq2UECk,4041
+komus_tasks/cli/runtime/output.py,sha256=-ceToKhE6u3OkKR2qNoUSfJ4Hfvhrf8bcWW2AXgb1ko,3437
+komus_tasks/cli/runtime/profile.py,sha256=DVWWVC_m3JODiWyt_DKitCvI3i9PGKtG22pxzMZ45-U,5682
+komus_tasks/cli/runtime/remote.py,sha256=2E3bveVcXzDbh1SgwfUaBk-inoTqAV_UkNaaRmd2Jr8,2178
+komus_tasks/cli/runtime/resolver.py,sha256=RaJpyCsWn9XEZpIGp0bplpQRjxGI9EHhmveSL8PB_9k,2777
+komus_tasks/cli/runtime/tty.py,sha256=ZNinUZOpctSoJnSfeAZUBKJQpk0aKJCSMB52Nc8knx4,893
+komus_tasks/cli/runtime/validation.py,sha256=T1RaJHVIidmO4ye9PEFAQvZghGlVBD1H8F1yhzqnTog,16649
+komus_tasks/cli/scaffolding/__init__.py,sha256=LIYnvR0pmeOcnYWPtV3NyucIUUSpt2zCnltPOwHr8NI,49
+komus_tasks/cli/scaffolding/gitignore.py,sha256=hVCydYLjUF6FHBwL-bLGzJkAhftmokayCkYmzr2wrDs,765
+komus_tasks/cli/scaffolding/node.py,sha256=Z1Q83vzx_jaPzMhUbvlk2cNny-ssSE14LMIsQ-ztYYA,4598
+komus_tasks/cli/scaffolding/python.py,sha256=rjFkfhoax6aBixHP6ds2G6VTJeWJeaaUhKUG2p2hCeM,7106
+komus_tasks/cli/schemas/__init__.py,sha256=AVGoU2s4wo_TmGNr_yIuKzgWKKeKukfE3tHKFiEPxGE,77
+komus_tasks/cli/schemas/activate.py,sha256=qJykTRy4_YWSB9LggiWU56zIf_XermyNKBcD9rls-7Q,268
+komus_tasks/cli/schemas/agents.py,sha256=dm2wHQLE-w3de5y5Nvei6d9E-DXvs-1ABXh6xj_b61Y,957
+komus_tasks/cli/schemas/artifact.py,sha256=lCWilzU0of_s7cM78NkM9v2ANslq-L6HThMXvucKUUc,1059
+komus_tasks/cli/schemas/common.py,sha256=OugqQ-KochmtYh9Buo2koOARMWlCOduj_pYd1XBwOpE,278
+komus_tasks/cli/schemas/config.py,sha256=0Cg4ahG3MmrF_MWaQkUc2OP2LfwYIirNU81juo1fxgA,292
+komus_tasks/cli/schemas/config_remote.py,sha256=MnGXa3FnsTbR-mJW6tL-opSc1BElvuLw9kn-6gTgYNg,470
+komus_tasks/cli/schemas/credentials.py,sha256=cQIZhgfcNSVjnqCRzPHsnxTH5cGx9S_CxNm1zEMvzIs,642
+komus_tasks/cli/schemas/deploy.py,sha256=NvfqmcffJhzjP86N63lK0Cu8F2sELv04XswWV40Y1sI,358
+komus_tasks/cli/schemas/environments.py,sha256=R4vqSowp58Yo7sI4hxjI38qoD6PilHxrgKICreyFG44,864
+komus_tasks/cli/schemas/files.py,sha256=xvpUjDewCp4wyo7-McWlozrkZOFbq4fO_a5ldVZ8dd8,630
+komus_tasks/cli/schemas/generate.py,sha256=LbvzCOZT2AJ2SVCMLScd1WVz63DdDQcniQgN1WlioKo,1161
+komus_tasks/cli/schemas/init.py,sha256=Lnkq4PA6tHt_NoobQ8Ffq50Z5TQ_39yA4wkI3W7u7jU,216
+komus_tasks/cli/schemas/local_result.py,sha256=fXGYzAbTO8A562F1TaFGDwrcocqaKpF-nI12R__cnGI,311
+komus_tasks/cli/schemas/log_event.py,sha256=f_1Z0e6QaM-gghr6aAzcO_AVxhx4K_cHjZ2wXisf6II,324
+komus_tasks/cli/schemas/long_running.py,sha256=hTl6dE7iTiilwgQIp6w3Pd8-7_gRwPYRGjIE8MXyC9A,675
+komus_tasks/cli/schemas/package.py,sha256=q778BujXgFP0G_t4RGqdoTdreoL0VFdsiPA29MpOkpU,192
+komus_tasks/cli/schemas/page.py,sha256=ym24Cht18dpi0CzsyrRah-IylTzJC24WN525ijNQKD0,507
+komus_tasks/cli/schemas/profile.py,sha256=IxOx-tzNahtciMmxjy1_879zzNie423PNMpeheXXi5s,259
+komus_tasks/cli/schemas/promote.py,sha256=7aJvXlFF0PAWJI7Dwn8hOZOrTpC7Q7ULPwi1KvCI56I,254
+komus_tasks/cli/schemas/run.py,sha256=dHFsG1uvUTeFYtC1FK32ERBdkB0oPctf6rWWZda-7i8,221
+komus_tasks/cli/schemas/schedule.py,sha256=w9yfauSI_Egj2XjbK1OCCgkzY6g9DzW3geurkScg0f8,1326
+komus_tasks/cli/schemas/skills.py,sha256=xc7sMaE60ij8cfYqRblBlSqdJ91y5DniDLOGFTCnqQo,580
+komus_tasks/cli/schemas/status.py,sha256=Zw8UFGvrWqKzy_fkK5ef4KG8x7T5qJO8MlWyTzpzau4,1560
+komus_tasks/cli/schemas/task_list.py,sha256=5XuPkAr2sbhv_LpCsv6YFIZuf9H-DdcAhYZUiDned_A,302
+komus_tasks/cli/schemas/tasks_admin.py,sha256=K-2vYXswFARXijXFg05n3FnxlrFwe-DldSsi94zKpsE,388
+komus_tasks/cli/schemas/webhooks.py,sha256=MfUPM7y8p42tABwX_KXEYKtFpgM7_3YvNQ394iauEaE,1274
+komus_tasks/cli/ui/__init__.py,sha256=HrYiTlv0CdAh_5byHV7hWbxS-cxvn1nRN2HJ8gEQU6A,65
+komus_tasks/cli/ui/prompts.py,sha256=cOu4U4pk5ylKrWp_QiF5xSrF_BlEHIfh5onMOSQP9H0,4325
+komus_tasks/cli/ui/theme.py,sha256=0rYSg2zZ4qyBq76I3u_N81BmTruc7NHlgLeYlSsAAXI,727
+komus_tasks/cli/ui/widgets.py,sha256=t77fghYfI6ID5QTPZ_jeBtMNcOeILjz4v1j3pRYrb-4,1168
+komus_tasks/cli/ui/writer.py,sha256=3vXNc94CbekjwrrErulo2eRcORkneruOrrn6pkXrB10,2285
+komus_tasks/cli/ui_commands/__init__.py,sha256=9w-m-SBFEyVcU09iiKPWkLcP1a_23Hon_ioXkq54jlE,70
+komus_tasks/cli/ui_commands/dashboard.py,sha256=x3-E0YHIfCWpTBcph9X3PORGEIae9CzX9vJGUBCXVK0,20186
+komus_tasks/cli/ui_commands/generate.py,sha256=RAb0YgJpmFUbVDxpdxihWEt0J9vTTuVmJAhX6RX9AxQ,5265
+komus_tasks/cli/ui_commands/monitor.py,sha256=xjDAwYu0RsL0P0bKmIKXtpTLSXjMRjoVmN2kfM3vVLg,5672
+komus_tasks/models/__init__.py,sha256=r0zEMxLn_X0NIafu4sPrSDWoOCrlPFYud_ooaumbl1o,1745
+komus_tasks/models/artifact.py,sha256=x3e1FZGls7GNBlUQDjT9iW2UGHXqg5-l2xrmWfipS4U,5049
+komus_tasks/models/artifact_download_response.py,sha256=fQXg5vIzwR0-A8Nmeu4GUGEg6aIyWZZBCM9sspohplE,421
+komus_tasks/models/artifact_list_response.py,sha256=yVFbRtqEDAaLoR-5uXFqkVugLPIMKtXmOhqUt5AQZDI,447
+komus_tasks/models/artifact_query_filters.py,sha256=11DnTZ5WKg51lMk6GZLQYB63jlvvw-rYaE5sIv-fJRI,816
+komus_tasks/models/artifact_schema.py,sha256=whYp5eP9OyhnVQ49dFvayqXFVCk_6HvGVVHP1VYs6wc,7834
+komus_tasks/models/credential.py,sha256=F2fVpExcZhVspVk7fuRzPKBx6W3u3QiIwdRqbrenzRQ,4829
+komus_tasks/models/environment.py,sha256=Iofyslwm1dLCubLO6UeH5vyIZJ526_qri-ifElk_R8k,8474
+komus_tasks/models/file_upload.py,sha256=b8Jj2pE2MsnAg2B0tj-uDVbs7n0gQYr9iIQshP1xcNc,2339
+komus_tasks/models/log_models.py,sha256=RpuSM-EVK4SqHy1E_EcycZxxW8Mhc5TDlzHnObde23w,10492
+komus_tasks/models/pagination.py,sha256=ulAGyTUocdigpHOnrLwDH7vS7r2cAEvXl5wtFHPzEtw,823
+komus_tasks/models/schedule.py,sha256=-MN4CZUSL3sXCIt53fu46pdDhIc6ySczeSK4QGSHVZc,9732
+komus_tasks/models/settings.py,sha256=AzmuDBi_WM-QWQIUghTsm1OyXKydm-Emr0S64s0crgA,2232
+komus_tasks/models/task_definition.py,sha256=jwSWpwaSM1nclzyx6wgpif2i_3iPOpudSO8xhhmrQNw,7875
+komus_tasks/models/thread.py,sha256=X0etX0YK2zD41yX2PMcjNqG5s0ehdD-YHWCif5lhkCk,4713
+komus_tasks/models/thread_create_request.py,sha256=6B1JfOGwE_14BA6qw2LH5q31UOIYj1c5cSy53HUlXeE,3236
+komus_tasks/models/thread_error.py,sha256=9WNx52arHi75eoBZCB_1e5pKj_zjXrwsgrGcTLHQyNg,606
+komus_tasks/models/thread_list_response.py,sha256=AsbiRyQ69PvQSb1KOFlFxLkK7DmBTVNSRUDQShnkqb0,617
+komus_tasks/models/thread_query_filters.py,sha256=2em_eWQ-gHbQKiIMl-XSZpZptboXsaAbgj9NkAWfjjI,4318
+komus_tasks/models/thread_retry_request.py,sha256=Gqp_GlqnujZDuePnCBvVARdq7e4UgTI2dJ-WWrTKdnk,422
+komus_tasks/models/webhook.py,sha256=1t50BrrYk0fDMwRM0Eh8hHWsq8CYMo5g0-oF-jO0IVg,12288
+komus_tasks/models/webhook_scoping.py,sha256=ziS-nk4zYjw_ihOGozpdtV_-sLX-Hj04yFyjLBgR1gI,1193
+komus_tasks/protocols/__init__.py,sha256=6Ikde1uHULpvOOw3fZOBS0BuqUl7HcvP3Ur35X3dt1s,634
+komus_tasks/protocols/artifact_publisher.py,sha256=XHOr-64BxEZeltcqKZ9BzNguluWm1tLrmkVbT600NTY,2458
+komus_tasks/protocols/log_configurator.py,sha256=bq8r0No5k_7hBy5PWggnsYG6OxXZckw3jLbOzkb5OIc,2331
+komus_tasks/skills/manage-komus-server/SKILL.md,sha256=M6sv403BHVZTX16WP26ndh_hOHQgmYj1ONsGRObhNPM,8173
+komus_tasks/skills/manage-komus-server/references/commands.md,sha256=Lqiy2OZsu09dCUTttG5IEl08XmG-BO39vXtgywxauec,7629
+komus_tasks/skills/manage-komus-server/references/workflows.md,sha256=D0b8Cn7t-fFAGepWsdlsPbSUt-273LKaMUD_UF2gCfs,10009
+komus_tasks/skills/manage-komus-server/references/permissions/agents.md,sha256=HqYXyyn31X8nTZU-LG8ZU10ZoVj9DMsJbRS1ceAhyCY,1149
+komus_tasks/skills/manage-komus-server/references/permissions/claude.md,sha256=Bz3cMVDJGm1GowwkroqQRxIfX7Z7q1EIhS3axQQ6oWM,1117
+komus_tasks/skills/manage-komus-server/references/permissions/codex.md,sha256=QOBpnV66dtkrpnwBsFmIFE3d94Ixcvd7HOIfY4HCoKM,1338
+komus_tasks/skills/manage-komus-server/references/permissions/cursor.md,sha256=OGoEn5X3O2oigNvjAQk7F_cVMJAMrYgq4orswbLuQMQ,1357
+komus_tasks/skills/write-komus-task/SKILL.md,sha256=cJxWfySKrLK7-ax2tE3O6zmWDb8_fs3PxjkYo4hUGUg,7298
+komus_tasks/skills/write-komus-task/references/configuration.md,sha256=z6kN630yUYoH10d_rDyDdZ2K_T4ReW7d2HPh2fhAGvU,1831
+komus_tasks/skills/write-komus-task/references/inputs-and-outputs.md,sha256=kSS-uYWkJDn9WCVpnSHhehUtb-NwqlO6_ElSiqPFdh8,1755
+komus_tasks/skills/write-komus-task/references/long-running.md,sha256=-K9uIEY74VFVTodCDbJDM8ntuj7EkzcDtdWhQfkRIkc,1438
+komus_tasks/skills/write-komus-task/references/packaging.md,sha256=6ygcrfktT1VNVm-jKEy1NOs6wQG_D6HOmztixbY8csA,2434
+komus_tasks/skills/write-komus-task/references/spans.md,sha256=qe3xz9oPbpIT2YFSByZUvw9nwptW7LBnZMXD044aaag,2429
+komus_tasks/skills/write-komus-task/references/task-contract.md,sha256=hIbbBPFu9LkcpA9aHyiuxY07VAUGy3N2Xr6b6JqR6Xs,11017
+komus_tasks/skills/write-komus-task/references/example-node/input.json,sha256=EWNt3nZpsrHtjSrEu_2y1Qpd__wqBivIuiMjmAzlmn0,116
+komus_tasks/skills/write-komus-task/references/example-node/task.ts,sha256=L9RtoGUZ8kGoIeTEo-Xpm0YVyc43QLzAaBdtZaIW-DM,1902
+komus_tasks/skills/write-komus-task/references/example-node/task.yaml,sha256=CMwv9RyTHe_kpjMPEjFQp3hn5gChgcfyLiEw8PKvGls,492
+komus_tasks/skills/write-komus-task/references/example-python/input.json,sha256=EWNt3nZpsrHtjSrEu_2y1Qpd__wqBivIuiMjmAzlmn0,116
+komus_tasks/skills/write-komus-task/references/example-python/task.py,sha256=qnSQvh6Hs9eyTR84RjmFU4kwd0wPnYJ2fieyxVEA2Uk,2017
+komus_tasks/skills/write-komus-task/references/example-python/task.yaml,sha256=uK_hYJ4-kuEUU0GRwtroG5cONVXIyMZ_-WCwbuiBxUw,486
+komus_tasks/testing/__init__.py,sha256=E56kWhALT6tu8Yqzk-WP_lIwxKdKLQYd_5pJMan7EZ4,761
+komus_tasks/testing/local_context.py,sha256=CPF-ggVC9VnWdYOUUhVEsD6dJzAxxOw2hZHM80PR4dE,6516
+komus_tasks/testing/local_runner.py,sha256=TLk2xcP6yyyqhalIn7v7dqIAUjRq3NdAVWu6Q2frw5k,16143
+komus_tasks/testing/run_result.py,sha256=KB4PdFMmg6KXeDWmMDkzZQQHHL-zvgSnU9j5YL9TVj8,2027
+komus_tasks/utils/__init__.py,sha256=kfK2V-eEjMwBiFziQyTAO-E5g00rRZJFFD9Z2wqKZbM,45
+komus_tasks/utils/artifact_validation.py,sha256=9yNd2IAfX1t_rEuN_25JPEDvanWd8NwFscrCTTTkDg0,4418
+komus_tasks/utils/id_generator.py,sha256=TGf1uU-wwPkNZfQ402Fk5bw6HNjQ2m_Yfw5CuVn-pig,1520
+komus_tasks/utils/ref_filtering.py,sha256=aBiJZt4Ddyu__NmEx56T0JjYJHGHX-Ffw-KF2UmCrOM,916
+komus_tasks/utils/sha256.py,sha256=fZicLQJNhvyxlw79K5c6xVtg7vJzzYqW9PW4tEoL_rs,1337
+komus_tasks/utils/task_packaging.py,sha256=D5MeG58EWdo3fKrbDYsFhC3esYv4q9Aeiv0TeMImAHU,33929
+komus_tasks/worker/__init__.py,sha256=SxqIQ0kuYiJSfqBi9uhNXjVMhfkmLBBjX66qU_TEyzI,290
+komus_tasks/worker/__main__.py,sha256=KNU-jKzHv_AWe3ZAWYz0z4pce6C-MG41LTMZq1kemFA,1102
+komus_tasks/worker/context.py,sha256=mFsaOzX8Q9K87V6zmo6YmyTykE2O0NwSNYK8cytZxfM,8978
+komus_tasks/worker/node-runner.js,sha256=NBqTDQn358a2zigMg98s1Ix2NQSoQQg4b0azdcaJuVU,19792
+komus_tasks/worker/protocol.py,sha256=lOCuaw9ANomSFJTsCRef7NN-pPIaaBEl3mHKBkZYkJc,8002
+komus_tasks/worker/runner.py,sha256=kVFD9R7yVCTVSP2YRRFTmTIhKSV4xwjyRNlEqmSSZ0A,26671
+komus_tasks/worker/worker-context.js,sha256=RSH7IavyqvPY2LpxhiaBivwKk1hL3hJOlUHOVTHUlp4,4980
+ko_tasks_sdk-1.0.0.dist-info/METADATA,sha256=0fvPSozbxX0C83vId1pK8Pd15UglQ_6O_T3d_n4aHjA,4489
+ko_tasks_sdk-1.0.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+ko_tasks_sdk-1.0.0.dist-info/entry_points.txt,sha256=XTXSjy7QZTnKc_FsFZYawe2fXIbsM379ibrQfE5eNgE,99
+ko_tasks_sdk-1.0.0.dist-info/RECORD,,

ko_tasks_sdk-1.0.0.dist-info/WHEEL

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

ko_tasks_sdk-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ko-tasks = komus_tasks.cli:main
+ko-tasks-agent = komus_tasks.agent.__main__:main

komus_tasks/__init__.py

@@ -0,0 +1,16 @@
+"""Komus Tasks Python SDK — Build and run tasks with ease."""
+
+from komus_tasks.context import TaskContext
+from komus_tasks.decorators import task, get_task_registry, discover_tasks_in_module
+from komus_tasks.thread_state import ThreadState
+from komus_tasks.version import __version__, get_sdk_version
+
+__all__ = [
+    "TaskContext",
+    "ThreadState",
+    "task",
+    "get_task_registry",
+    "discover_tasks_in_module",
+    "__version__",
+    "get_sdk_version",
+]

komus_tasks/agent/__init__.py

@@ -0,0 +1,20 @@
+"""Remote worker agent (client side).
+
+The agent dials *into* the Komus Tasks server over a WebSocket (outbound-only —
+the VM running the agent needs no inbound ports / public IP), registers its
+runtimes and slot capacity, and on demand provisions task bundles and spawns the
+**existing local worker runner** (``python -m komus_tasks.worker`` /
+``node node-runner.js``). The worker's NDJSON protocol frames are tunnelled over
+the connection; the server's ``NetworkTransport`` is the other end of that pipe.
+
+Ships inside ``ko-tasks-sdk`` so ``pip install ko-tasks-sdk[agent]``
+provides the ``ko-tasks-agent`` console script.
+
+This package is importable **without** the optional ``websockets`` dependency:
+the import is performed lazily inside :class:`~komus_tasks.agent.client.AgentClient`
+so the SDK keeps importing cleanly when the ``agent`` extra is not installed.
+"""
+
+from komus_tasks.agent.client import AgentClient, AgentConfig
+
+__all__ = ["AgentClient", "AgentConfig"]

komus_tasks/agent/__main__.py

@@ -0,0 +1,114 @@
+"""``ko-tasks-agent`` CLI — run a remote worker agent.
+
+Dials into a Komus Tasks server over WebSocket, registers this host's runtimes
+and slot capacity, then provisions task bundles and runs local workers on demand,
+tunnelling their protocol frames back to the server.
+
+Usage:
+    python -m komus_tasks.agent \\
+        --server-url wss://tasks.example.com/agent/connect \\
+        --token "$KO_TASKS_AGENT_TOKEN" \\
+        --labels python,node \\
+        --max-slots 8 \\
+        --work-dir /var/lib/ko-tasks-agent
+
+Environment fallbacks:
+    KO_TASKS_AGENT_SERVER_URL  →  --server-url
+    KO_TASKS_AGENT_TOKEN       →  --token
+"""
+
+import argparse
+import asyncio
+import os
+import sys
+from pathlib import Path
+
+from komus_tasks.agent.client import AgentClient, AgentConfig, HelloRejected
+from komus_tasks.logging import configure_logging, logger
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="ko-tasks-agent",
+        description=(
+            "Run a Komus Tasks remote worker agent. The agent dials into the "
+            "server (outbound-only), registers its runtimes/slots, and runs "
+            "task workers on this host on demand."
+        ),
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    )
+    parser.add_argument(
+        "--server-url",
+        default=os.environ.get("KO_TASKS_AGENT_SERVER_URL"),
+        help="WebSocket URL of the server agent gateway "
+        "(e.g. wss://host/agent/connect). Env: KO_TASKS_AGENT_SERVER_URL.",
+    )
+    parser.add_argument(
+        "--token",
+        default=os.environ.get("KO_TASKS_AGENT_TOKEN"),
+        help="Shared agent auth token presented in `hello`. Env: KO_TASKS_AGENT_TOKEN.",
+    )
+    parser.add_argument(
+        "--labels",
+        default="python",
+        help="Comma-separated runtimes this agent can run (e.g. python,node).",
+    )
+    parser.add_argument(
+        "--max-slots",
+        type=int,
+        default=4,
+        help="Maximum concurrent worker leases this agent will accept.",
+    )
+    parser.add_argument(
+        "--work-dir",
+        type=Path,
+        default=Path.home() / ".ko-tasks-agent" / "work",
+        help="Directory for unpacked task bundles and per-lease venvs.",
+    )
+    parser.add_argument(
+        "--agent-id",
+        default=None,
+        help="Stable agent identifier (defaults to host-pid).",
+    )
+    return parser
+
+
+def main() -> None:
+    configure_logging()
+    parser = _build_parser()
+    args = parser.parse_args()
+
+    if not args.server_url:
+        parser.error("--server-url is required (or set KO_TASKS_AGENT_SERVER_URL)")
+    if not args.token:
+        parser.error("--token is required (or set KO_TASKS_AGENT_TOKEN)")
+
+    runtimes = [r.strip() for r in args.labels.split(",") if r.strip()]
+    if not runtimes:
+        runtimes = ["python"]
+
+    config_kwargs: dict = {
+        "server_url": args.server_url,
+        "token": args.token,
+        "runtimes": runtimes,
+        "max_slots": args.max_slots,
+        "work_dir": args.work_dir,
+    }
+    if args.agent_id:
+        config_kwargs["agent_id"] = args.agent_id
+
+    config = AgentConfig(**config_kwargs)
+    client = AgentClient(config)
+
+    try:
+        asyncio.run(client.run_forever())
+    except HelloRejected as exc:
+        logger.error("agent.rejected", reason=str(exc))
+        sys.exit(2)
+    except KeyboardInterrupt:
+        logger.info("agent.shutdown")
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()