lazycloud-shared 0.0.0__py3-none-any.whl

lazycloud_shared-0.0.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: lazycloud-shared
+Version: 0.0.0
+Summary: Boundary-safe shared primitives and HTTP payloads for the compute platform.
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2025.1.31
+Requires-Dist: croniter>=6.2.4
+Requires-Dist: pydantic<3,>=2.8

lazycloud_shared-0.0.0.dist-info/RECORD

@@ -0,0 +1,126 @@
+shared/__init__.py,sha256=kKDUnghi3XUPIATQle0obOsNlzlfOOFL0P8Efg4TxpE,77
+shared/app_identity.py,sha256=hZF37GQffNJxS8VUGXl5WNcvQd4nYRPk2QTgWF_HMaU,4485
+shared/app_lifecycle.py,sha256=JuhIF_-gd6IDudaqV5EDpYGFGt4Q4wv94y9WeXZ-EPo,850
+shared/app_slug.py,sha256=YZ0GlbGYH1Xy_IpSngF02mDHmSqPn3nBAWmVT4x_2yA,1193
+shared/autoscaler_state.py,sha256=cJ929AnMsfTkkJkYgCHHvRO002QA7Dp4N7kPR4ydwp8,1329
+shared/autoscaling.py,sha256=Ea-AetNeSvr-PbM-3BzaFV1-qeKLnFaOzyTmyC-EaEI,12582
+shared/aws_connections.py,sha256=uZpAJ92BEeYuJC2HMulgnRBHitfkEGnUGCgvW8bbAJQ,27156
+shared/billing_accounts.py,sha256=qTQ8zCrh3cozs0WqmFPvBSxi14ZIU4BzZDF8OTP25b4,4412
+shared/billing_plans.py,sha256=xVyPcbiQnln9tcBrM6Jw15QYCK5-RBvRaFV2i_ulHJ8,603
+shared/billing_quotes.py,sha256=XyE-D-lcB1tGrjd8MXXml6PYZV50CH45K8O8zMXzaDg,16843
+shared/billing_rate_card.py,sha256=fQiSMFa4-dpV3TqxdNlazCPiAaMJd4ohhS1DbrmI3TM,25264
+shared/bytes_transport.py,sha256=_PaBbxEOB-XF2vTAQXvfUkMQs2Ftlg4ju71NXxyhor4,861
+shared/cache_records.py,sha256=kP9t-CE4ZX-y2O1v5mryyJa1-Ft8XHVWbXGXwKplMMQ,476
+shared/callbacks.py,sha256=Gt_N45fl7zb666kbD3wmsnuonjRTtvsQlO6-DOFRVMA,1001
+shared/capacity.py,sha256=F-BvrVuQw3bCWjXof6JaBHitCagxjDdbyNCyT86qpSg,8794
+shared/checkpoints.py,sha256=DvzO95SR3GUWwoGDzzqgY_N-amj7O9DOhV3lNyjXXvk,2076
+shared/compute_enrollment.py,sha256=Gw_37Bc4vulkOW_hLnSI2zLsSsWr7UEjtIeRRnDR3_8,4262
+shared/compute_fleet.py,sha256=5X0jwvKN0W4vOvw29e8cv9OKFcEWiNpuUwY4VaThtwg,2581
+shared/compute_policy.py,sha256=f3QpzJIJPD5y1PABR8ojxUJIgqK4uLSTbyRACrZ4K2k,11564
+shared/container_requests.py,sha256=Xdt9g5AES4yhXrosj521OKessBxr0PwNjw7MumYGOx8,15997
+shared/containers.py,sha256=xm5E2PaaD4sx0L4hh-FlzPY-SPBrFROojPHDTmUfm2U,2693
+shared/contracts.py,sha256=bpbnQJxn3Yy1PbSpYla6G2eTq7RgEaF21QSBjUZ3j-o,179
+shared/cron.py,sha256=83D2tmOMxajMuYofOTcZnMzG-uXBH5QuB1EE1BJMJGM,2845
+shared/custom_domains.py,sha256=Y5sOXp-E8AAJDuAChhgNgcyDhZ4dlNCvgBXVSYNDKE8,5468
+shared/deployment_records.py,sha256=MSOC-HG2LmbV7E2T8zV44gBbXzIlGRpamV1-TGe4U7I,17060
+shared/deployment_settings.py,sha256=2Us-nZR-CbPsLgutDhWl8VFvjFPDGQjzoOX5YUL8WoU,1064
+shared/deployment_subdomains.py,sha256=wWSUSVo59cWCIHgUKFxwC13xgMU6Bm-sCuwZARrYlvs,3922
+shared/deployments.py,sha256=jDicoYySDK5s0u4883cH2lMm5eCfT0JVpI1LBHLPLTk,433
+shared/enums.py,sha256=IHJi97VHgrV4Oj2DsO-3Yg-VQqVA32A3-_QpVt8Gq-k,215
+shared/env.py,sha256=YwzykbVppqODUeQZzWSALAogVg4LA_wldOsk-NnvcAs,5477
+shared/errors.py,sha256=YaON9DLGFCd-u03b5dkYSoVmwtyzGKfyaWncdVqX3hc,1999
+shared/events.py,sha256=FmFiPIVp_32KEFAwN3wL2o4hwiT8tV2ln_dsIEUvAxI,631
+shared/external_identity.py,sha256=kpVqPXUSPBvX9qNjeaTxo6hZ_FYJsIpPr58Vbfd8ZpI,1736
+shared/function_payloads.py,sha256=EWbK9_jU9__dOMsAV7Hl8tRps-M1hoBZqY62ZyG0Tig,7489
+shared/gpu.py,sha256=r50INDwOQekhd9FysDRAf8p6cKuZnSRziBDtb3Xtemo,8227
+shared/http_headers.py,sha256=TAKIypZFvFO4pqcoxkqyPETK8rhy_reHfj_C5iEFTFY,1964
+shared/http_transport.py,sha256=q5iqzDUkTx9vNEMoNixRaGFfKuJccbuiPzPqilh5PG4,6326
+shared/identity.py,sha256=1xbkN4r2kmmponR1MUAn8P9gGLtGVIWOunkx-jZ6wPM,9071
+shared/lifecycle.py,sha256=MhKHfpd7pkgXBaLvmEHnFPs39b3UqPuj3eVQvT_mAGM,3389
+shared/logs.py,sha256=k1-koZnFQ74Keu9nne-5rSPfF9MC7QXrD-HDs8ZcT98,944
+shared/managed_runtime_integrity.py,sha256=-hY6OcAnYLqScwX4v_2AaCWjWFunKaGvstZ64Zp4cYo,3328
+shared/mounts.py,sha256=uWTkASpRd2bk_rVwxqtd-OpTGN9ZakSoPug-_M7jFww,1933
+shared/objects.py,sha256=NmJ_bhhNDDE7bj1EVHPUvk7A0ZOxUqe1fgJ80jAxmNU,1150
+shared/paths.py,sha256=LiFCHohIx9dRPxYqbvkmlMlHbhFnNCDqRwWyqLLxFpk,507
+shared/payments.py,sha256=RxmK6KDUQTCwuyAivQjFOJ42PfMx3BWyFohPlOb7WnY,19094
+shared/process_liveness.py,sha256=m7_jHMfVhcxI5VgUrYpqRJ4-CNxPLMwq-wPtkobx6P8,2849
+shared/provider_config.py,sha256=MyhcI-p4COF14m7Cai6gzkVWOhI46Rykjg5T9LhN9JA,700
+shared/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+shared/queue_messages.py,sha256=ux-407dOW9Z0tqLwUkZURpKC4HxZU3wBIDd8_6Awpb4,569
+shared/resources.py,sha256=oa4bAQvWIzc-q4966iiOW7Q8fgf8EJ0-S_NrfrV4QhY,784
+shared/routing.py,sha256=MCjrdiuzlZhr3aajkprFFcihZStNaFWxQlBgZakm4bk,2445
+shared/runtime_paths.py,sha256=eyMZrg9noO9a37i1wvBakejgB3-Wvd9IbVwq9xlQAbg,369
+shared/scheduling.py,sha256=GMkm01wi40DhnfoEukBjaO_saHSynLAvawm53QzQX1Q,12613
+shared/secrets.py,sha256=VU5NiNpizdpPATphjgsqbxmYzirxaM_fmTuj3B_Yjd8,552
+shared/serialization.py,sha256=Iq9muTemq8XdcRRVfxgOnEFyKEG4WQxWCNLi49AQ86Q,6357
+shared/shell_protocol.py,sha256=84zbks7tAQ26DdED1loj-R_51j082w6KkM7b2wze0Qk,3606
+shared/signals.py,sha256=UFgu1qut0scjtWfXRWkvO0yzlJGnWRYGvCOawabVBrw,6215
+shared/source_cache_cleanup.py,sha256=y8LwABTIsA6gOk6ZLyuckcPAjJCd48lTIHRh_mppapM,4634
+shared/task_context.py,sha256=yCM42ltgklV4rUjjopboQ8h5EHs1gzq5KHJvaUtEq-8,2539
+shared/tasks.py,sha256=eeff1-tl8C7hltVj-vOqIujKW0sJgzZbUP9qbqpIl-w,8632
+shared/timestamps.py,sha256=ha3gHn1OiJ72rEZdYs9wrBdMq47UBwJNhktxcB2w7hg,639
+shared/transport_retry.py,sha256=eUc3V9ynwpxVGwr9qy0AD8mL-ZsX-D5ndMdv7GikCzI,4142
+shared/urls.py,sha256=zCbFWbIxn6Z329E3AyuXvWUV8Q5SUdhMA9LAOS6mTDM,7537
+shared/usage.py,sha256=trkT2B3xDYnXac871yt557VA05XQHPuAsuIFXRCj8qI,6221
+shared/usage_query.py,sha256=zuj0FG-TyptX_duM1lTdI23MaXX2OwHxU-xjW5_qUWc,450
+shared/volumes.py,sha256=k7ZGVJUMbc2jYAoaOtu1ZoXksdrd6OYr0MN3JjpKtAY,297
+shared/worker_events.py,sha256=Aaf3LIrk3Ns0Mll8GID69bEhdegTOb_Q64jz0E8vw4Q,1878
+shared/workload_config.py,sha256=0NdtQT-YC3PXcWGnRLm7N8iHfS1rCrj5cFUwPYCOxKc,12046
+shared/workload_keys.py,sha256=CpWC3mNbZBvxyerLkXmzL6MY1SYc2SjECxRtRXNgsVI,945
+shared/workspace_storage.py,sha256=DNNytFaG_29fqfnyHLlde-8qdhY1EgVk-v-1U7AMoH4,3508
+shared/http/__init__.py,sha256=rL4jfmBThSdygQbABEVtF6sienPE4r5T5jV6nYHdl0E,73
+shared/http/apps.py,sha256=n5xbwOEYITM1nkCieh97qmT16ts8rSHH1W9nhQPAuEg,2450
+shared/http/artifacts.py,sha256=4YQ9Z0IiBd7i3Za7u0i0CSIqpwfw8soCrSK3eSgz5GE,1719
+shared/http/aws_connections.py,sha256=rmebeDMXVfc6qBotowKZORxjkh7tKePFXQFjujq2cjo,5137
+shared/http/base.py,sha256=0Fr0ABhbrAbOPrjgvnrgCcWXMmxFuOetGZ_VDkL8GjE,297
+shared/http/billing.py,sha256=00jBn9atJxxu7rR1wHbvv7xs61eQR7fzpKZm3am3DTA,7838
+shared/http/callbacks.py,sha256=mo7PjBHVya7usbM1uX5hKVl9NqYA8Htpx_KEcPs5REU,474
+shared/http/client_manifests.py,sha256=TvdujrBQ3jOsbTA5ZCIajHiXR7kVyvFUyP0xpa5vafI,3572
+shared/http/collections.py,sha256=wd-uhwUIks3tb7cjTe0jrqvAIk-5eTZN64GF5P_HAO8,2210
+shared/http/compute.py,sha256=GMXY3HHOi46yFJoiCv-enszlz_AhrEHzV8uArGa6-Sw,11492
+shared/http/compute_policy.py,sha256=xUUytgRy1OR4O1nZZpognDbYq7e0e34gm2RnC_ss5UI,5018
+shared/http/concurrency.py,sha256=vb-2eE3Y1dKZNqDzS6JU6h4qMg4Bh7UTAKYarXXoKL0,1280
+shared/http/custom_domains.py,sha256=UCZUTlNjV9RX5Zxcnj_GE_p8XaQCmtDzhfpVbh8OaJk,1878
+shared/http/deployments.py,sha256=zjy9nNG2Htx4kBnLguQvk2bOKfhsFOzXTTGuLzSEJMg,3299
+shared/http/device_auth.py,sha256=-d0W7Iq0VP_1IVS9jE93Frf3-k1pDbx_-vmfZMeLfvc,1413
+shared/http/endpoint_forwarding.py,sha256=AXrA2bZX9sfMUe03DNOMkxV9RoVr20nxD2t1XEbo_vw,9066
+shared/http/endpoints.py,sha256=OFeCbpYUsxDPsaYRhddIbe1y0dQ49HpIJrCc-3zHVuo,1837
+shared/http/errors.py,sha256=Mvw4D3tEPnnWBMS0XD_Ay3NJmAPyPjLssJSaNxriLtY,2331
+shared/http/functions.py,sha256=BgMfgpSjDkk0271uS7acCNuan0rkvP-Uu6A5x1ZQHNY,4371
+shared/http/gateway.py,sha256=W6F3XmY9HlSvF7fVI-cCn3dZpgRHxUdMI6IkASdlXrE,10230
+shared/http/gateway_tasks.py,sha256=sl_myC1V327-qCKne52QTsgdPD4grsjVJCnV-V9hg1o,1185
+shared/http/images.py,sha256=M5hOha0KgeeUAIbveJ3EZysPBBjSmzRO6H36lr3ktIQ,2358
+shared/http/objects.py,sha256=ToxdDpQgHvmNEL9i72IMinTe0yc5JhquVWjTdbdnDyA,3411
+shared/http/observability.py,sha256=e2mfG8QEOieLlwM_hIX5yxfQjr7bCFK8qE4TY2XHqbQ,11503
+shared/http/operations.py,sha256=EvrRxtBDhRLk2AZ8xJE7IvT1fbJkgkMeFdc9jdDOtgI,5715
+shared/http/pods.py,sha256=VziKi0IqBk0xzEnJt378YipB3VmMDeFnkOD9arl3zO0,7829
+shared/http/pricing.py,sha256=9b3wmyY4D3rEL64NgoUlUI4SULErJ7fkIzm9i5sBn9c,4926
+shared/http/provider_nodes.py,sha256=eK8mWJVnqcsIsRiCGVHpI1BQ93iPU9bupT-NlmGcCik,3949
+shared/http/secrets.py,sha256=kscNSzsoN-DLxWEtTZgM-0vWQOoZe9re9kUJyfIMm4M,2983
+shared/http/shells.py,sha256=Ls61IA7FVrkl-CcCkYqxF1kRscsDMuIxJa6On5yWaaY,1894
+shared/http/source_cache_cleanup.py,sha256=KQihb2Bd5qGk2HsqUWSHzyFG4vYB-cQ11dXIEm3eWe8,727
+shared/http/storage.py,sha256=IvXNnmONhz9tVTdsXK8cloW3mXtT8rYAH9QteUSnzs0,2221
+shared/http/stubs.py,sha256=EpclPTy4O0g7jBL1HXNwTBoeXOD30rVM0CapJpbp4RY,5302
+shared/http/system.py,sha256=P8hsPkS35RTI2Wry92wVkg6rNRrmXhgUMc8byqZv-xw,3991
+shared/http/task_payload.py,sha256=f6vaFEwWRDQ95T84pSdYjY-gGI5RauSJOPLmkFMgQcE,2314
+shared/http/tasks.py,sha256=Ndye-4Yu9T5HC7P6nHaDTXSGPG0EEdD5XAUz1EWPzpA,4252
+shared/http/usage.py,sha256=tLzswNTw82y_HFI2_Ua4G9AVu7laAug5y9HcVN884ls,7391
+shared/http/users.py,sha256=8piLrfslDYOjgLCJVWK1kZ-YZsesZvkyvqWo30rpTD4,3056
+shared/http/volumes.py,sha256=cnakMfJK-79oSMdUMDL_whEqVUpW2aKB8s_Oh05vHJY,5395
+shared/http/workspace_changes.py,sha256=qQwwsOlv9VqjJfN-bWxikLDluEnlKgBXXP4dtfH9ukQ,2327
+shared/http/workspaces.py,sha256=B-dGXCmyHnTF-IBTONbs5oEpvwkN18INNv1ufvRkQb4,4938
+shared/image_building/__init__.py,sha256=9u9Yx5JMq3hKyBKrGsskKorhhUhgBcjTZBhnbqvZ92E,595
+shared/image_building/authoring.py,sha256=IuCaZ8KeqCD2etFk-vJqfURK0yRqiOF8w1T2J3VrzEY,1661
+shared/image_building/constants.py,sha256=1-qoxfTEFd7LFS_vL8L-SMdZJH9Xr86qG-ncoI-dX1c,884
+shared/image_building/context.py,sha256=PsBmlv6dLsB0jrfu2IEJF8zcQrx24fehEEc3cLk-JGs,1730
+shared/image_building/credentials.py,sha256=fq9j7FCjSvX-t_zXRFcOGJ8H3H6Sr41iIdaP3WcFRDc,7953
+shared/image_building/planning.py,sha256=va5azNmvaMGvHYHM7t3inok3zCkF60wV-Vwqgf261rM,376
+shared/image_building/records.py,sha256=szyJW5QH6IHavfsWaIhZcfyWRRlHbJYYlnSsl4Hy5U8,2354
+shared/image_building/requirements.py,sha256=c3-TA81OLr81WZOGkyub4Z9EyWS97A9lYuVXsjhash4,1614
+shared/realtime/__init__.py,sha256=KWxT4ZXAHvm261_qRAZh2_b6qr0iypRFHGElstAT148,79
+shared/realtime/contracts.py,sha256=DGlh8afS79DPpMQiUFNQJigyIxF-kYlrDQsll9ZDFJQ,10195
+shared/realtime/streams.py,sha256=e5VO-4F7Ff5ZTv6iYoted49wRiT2O05q0IeYH2ROOsg,28914
+lazycloud_shared-0.0.0.dist-info/METADATA,sha256=hPVGjPGHnNmB0zhNOIUprokYQxfUunab5RJccUwv7cg,266
+lazycloud_shared-0.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+lazycloud_shared-0.0.0.dist-info/top_level.txt,sha256=z5mXWqeZX62G-ufzsJBRQ_MKUlAZRN_yYAKvyZw7hBk,7
+lazycloud_shared-0.0.0.dist-info/RECORD,,

lazycloud_shared-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

lazycloud_shared-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+shared

shared/__init__.py

@@ -0,0 +1 @@
+"""Protocol-neutral contracts shared across LazyCloud process boundaries."""

shared/app_identity.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+NAME = "lazycloud"
+DISPLAY_NAME = NAME.replace("-", " ").title()
+ENV_PREFIX = NAME.upper().replace("-", "_")
+_LABEL_NAME = "".join(part.capitalize() for part in NAME.replace("_", "-").split("-"))
+HOME_DIR = f".{NAME}"
+STATE_DIR = f"/var/lib/{NAME}"
+CACHE_DIR = f"{STATE_DIR}/cache"
+CACHE_PAGES_DIR = f"{CACHE_DIR}/pages"
+WORKER_BUNDLE_ROOT = f"/tmp/{NAME}-containers"
+WORKER_CHECKPOINT_ROOT = f"/tmp/{NAME}-checkpoints"
+CHECKPOINT_SIGNAL_ROOT = f"/tmp/{NAME}-checkpoint-signals"
+MANAGED_PACKAGE_ROOT = f"/tmp/{NAME}-packages"
+FUNCTION_IMAGE = f"{NAME}-function"
+ENDPOINT_IMAGE = f"{NAME}-endpoint"
+POD_IMAGE = f"{NAME}-pod"
+SHELL_IMAGE = f"{NAME}-shell"
+SHELL_LOG_PATH = f"/tmp/{NAME}-shell.log"
+AGENT_CONTAINER_TMP_PATH = f"/tmp/{NAME}"
+AGENT_CONTAINER_LOG_PATH = f"/var/log/{NAME}"
+AGENT_STATE_DIR = f"{STATE_DIR}/agent"
+AGENT_CONTAINER_DATA_PATH = f"{AGENT_STATE_DIR}/data"
+AGENT_CONTAINER_OBJECT_PATH = f"{AGENT_CONTAINER_DATA_PATH}/objects"
+AGENT_WORKER_CONFIG_PATH = f"/etc/{NAME}/worker/config.json"
+CLI_NAME = NAME
+ADMIN_CLI_NAME = f"{NAME}-admin"
+REDIS_KEY_PREFIX = NAME
+OBJECT_STORE_BUCKET = f"{NAME}-objects"
+
+WORKSPACE_BUCKET_PREFIX = "workspace"
+"""Default prefix of a workspace's own bucket.
+
+A deployment sharing an AWS account with another one overrides this, because the
+grant that reaches `workspace-*` cannot otherwise tell two deployments apart.
+"""
+DATA_STORAGE_BUCKET = f"{NAME}-data"
+OBJECT_STORE_ACCESS_KEY_ID = NAME
+OBJECT_STORE_SECRET_ACCESS_KEY = f"{NAME}-secret"
+WORKSPACE_OBJECT_BUCKET = "default"
+IMAGE_BUILD_CONTEXT_BUCKET = "build-contexts"
+CLUSTER_NAME_LABEL = f"{_LABEL_NAME}ClusterName"
+POOL_NAME_LABEL = f"{_LABEL_NAME}PoolName"
+MACHINE_ID_LABEL = f"{_LABEL_NAME}MachineId"
+DEFAULT_RESOURCE_TYPE = NAME
+EVENT_SOURCE = f"{NAME}-cluster"
+INTERNAL_WEBHOOK_FORMAT = f"{NAME}-webhook"
+METRICS_NAMESPACE = NAME.replace("-", "_")
+AGENT_NAME = f"{NAME}-agent"
+AGENT_SERVICE_DESCRIPTION = f"{DISPLAY_NAME} agent"
+AGENT_LAUNCHD_LABEL_PREFIX = f"com.{NAME}.agent"
+CONTROL_PLANE_SERVICE_NAME = f"{NAME}-api"
+CONTROL_PLANE_IMAGE = "api"
+SCHEDULER_PROCESS_NAME = f"{NAME}-scheduler"
+SCHEDULER_IMAGE = "scheduler"
+CONTAINER_WORKER_PROCESS_NAME = f"{NAME}-container-worker"
+CONTAINER_WORKER_IMAGE = "container-worker"
+CONTAINER_HELPER_PATH = f"/usr/local/bin/{NAME}-sandbox-supervisor"
+WORKER_BOOTSTRAP_PROCESS_NAME = f"{NAME}-worker-bootstrap"
+WORKER_BOOTSTRAP_IMAGE = "worker-bootstrap"
+CACHE_SERVER_PROCESS_NAME = f"{NAME}-cache-server"
+CACHE_SERVER_IMAGE = "cache-server"
+SANDBOX_COMPOSE_OVERRIDE_PATH = f"/tmp/{NAME}-docker-compose.override.yml"
+METRICS_SOURCE = NAME
+PRIVATE_RESOURCE_PREFIX = f"{NAME}-private"
+SOURCE_CACHE_DIR = f"{NAME}-source-cache"
+SOURCE_PACKAGE_BUCKET = f"{NAME}-source-packages"
+WORKSPACE_UPLOAD_BUCKETS = frozenset(
+    {WORKSPACE_OBJECT_BUCKET, SOURCE_PACKAGE_BUCKET, IMAGE_BUILD_CONTEXT_BUCKET}
+)
+
+__all__ = [
+    "ADMIN_CLI_NAME",
+    "AGENT_CONTAINER_DATA_PATH",
+    "AGENT_CONTAINER_LOG_PATH",
+    "AGENT_CONTAINER_OBJECT_PATH",
+    "AGENT_CONTAINER_TMP_PATH",
+    "AGENT_LAUNCHD_LABEL_PREFIX",
+    "AGENT_NAME",
+    "AGENT_SERVICE_DESCRIPTION",
+    "AGENT_STATE_DIR",
+    "AGENT_WORKER_CONFIG_PATH",
+    "CACHE_DIR",
+    "CACHE_PAGES_DIR",
+    "CACHE_SERVER_IMAGE",
+    "CACHE_SERVER_PROCESS_NAME",
+    "CHECKPOINT_SIGNAL_ROOT",
+    "CLI_NAME",
+    "CLUSTER_NAME_LABEL",
+    "CONTAINER_HELPER_PATH",
+    "CONTAINER_WORKER_IMAGE",
+    "CONTAINER_WORKER_PROCESS_NAME",
+    "CONTROL_PLANE_IMAGE",
+    "CONTROL_PLANE_SERVICE_NAME",
+    "DATA_STORAGE_BUCKET",
+    "DEFAULT_RESOURCE_TYPE",
+    "DISPLAY_NAME",
+    "ENDPOINT_IMAGE",
+    "ENV_PREFIX",
+    "EVENT_SOURCE",
+    "FUNCTION_IMAGE",
+    "HOME_DIR",
+    "IMAGE_BUILD_CONTEXT_BUCKET",
+    "INTERNAL_WEBHOOK_FORMAT",
+    "MACHINE_ID_LABEL",
+    "MANAGED_PACKAGE_ROOT",
+    "METRICS_NAMESPACE",
+    "METRICS_SOURCE",
+    "NAME",
+    "OBJECT_STORE_ACCESS_KEY_ID",
+    "OBJECT_STORE_BUCKET",
+    "OBJECT_STORE_SECRET_ACCESS_KEY",
+    "POD_IMAGE",
+    "POOL_NAME_LABEL",
+    "PRIVATE_RESOURCE_PREFIX",
+    "REDIS_KEY_PREFIX",
+    "SANDBOX_COMPOSE_OVERRIDE_PATH",
+    "SCHEDULER_IMAGE",
+    "SCHEDULER_PROCESS_NAME",
+    "SHELL_IMAGE",
+    "SHELL_LOG_PATH",
+    "SOURCE_CACHE_DIR",
+    "SOURCE_PACKAGE_BUCKET",
+    "STATE_DIR",
+    "WORKER_BOOTSTRAP_IMAGE",
+    "WORKER_BOOTSTRAP_PROCESS_NAME",
+    "WORKER_BUNDLE_ROOT",
+    "WORKER_CHECKPOINT_ROOT",
+    "WORKSPACE_BUCKET_PREFIX",
+    "WORKSPACE_OBJECT_BUCKET",
+    "WORKSPACE_UPLOAD_BUCKETS",
+]

shared/app_lifecycle.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class AppLifecycleState(str, Enum):
+    Active = "active"
+    Pausing = "pausing"
+    Paused = "paused"
+    Resuming = "resuming"
+    Deleting = "deleting"
+    CleanupFailed = "cleanup_failed"
+    Deleted = "deleted"
+
+
+class AppLifecycleTarget(str, Enum):
+    Active = "active"
+    Paused = "paused"
+    Deleted = "deleted"
+
+
+class AppDeploymentIntentTarget(str, Enum):
+    Active = "active"
+    Inactive = "inactive"
+    Deleted = "deleted"
+
+
+UNFINISHED_APP_LIFECYCLE_STATES = frozenset(
+    {
+        AppLifecycleState.Pausing,
+        AppLifecycleState.Resuming,
+        AppLifecycleState.Deleting,
+        AppLifecycleState.CleanupFailed,
+    }
+)
+
+
+__all__ = [
+    "UNFINISHED_APP_LIFECYCLE_STATES",
+    "AppDeploymentIntentTarget",
+    "AppLifecycleState",
+    "AppLifecycleTarget",
+]

shared/app_slug.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import keyword
+import re
+
+APP_SLUG_PATTERN = re.compile(r"^[a-z][a-z0-9_]{0,62}$")
+
+
+def validate_app_slug(value: str) -> str:
+    slug = value.strip()
+    if not APP_SLUG_PATTERN.fullmatch(slug) or keyword.iskeyword(slug):
+        msg = (
+            "app slug must be a lowercase Python identifier segment, "
+            "start with a letter, and contain only lowercase letters, digits, or underscores"
+        )
+        raise ValueError(msg)
+    return slug
+
+
+def app_slug_from_name(value: str) -> str:
+    raw = value.strip().lower()
+    slug = re.sub(r"[^a-z0-9_]+", "_", raw).strip("_")
+    if not slug or not slug[0].isalpha():
+        slug = f"app_{slug or 'default'}"
+    if len(slug) > 63:
+        slug = slug[:63].rstrip("_")
+    if keyword.iskeyword(slug):
+        slug = f"{slug}_app"
+    return validate_app_slug(slug)
+
+
+def app_slug_or_default(value: str | None, *, default: str) -> str:
+    selected = (value or "").strip()
+    if selected:
+        return validate_app_slug(selected)
+    return app_slug_from_name(default)
+
+
+__all__ = [
+    "APP_SLUG_PATTERN",
+    "app_slug_from_name",
+    "app_slug_or_default",
+    "validate_app_slug",
+]

shared/autoscaler_state.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import Field, JsonValue
+
+from shared.contracts import ContractModel
+from shared.enums import StringEnum
+from shared.timestamps import utc_now
+
+
+class AutoscalerTargetKind(StringEnum):
+    Function = "function"
+    Endpoint = "endpoint"
+    Pod = "pod"
+
+
+class AutoscalerStateRecord(ContractModel):
+    name: str
+    workspace_id: str
+    source: str
+    target_kind: AutoscalerTargetKind
+    target_id: str
+    deployment_id: str = ""
+    app_id: str = ""
+    current_count: int = 0
+    desired_count: int = 0
+    signal_name: str = ""
+    signal_value: int = 0
+    decision: str = ""
+    reason: str = ""
+    active: bool = True
+    valid: bool = True
+    lock_acquired: bool = True
+    owner_lock_key: str = ""
+    cooldown_until: datetime | None = None
+    failed_container_count: int = 0
+    error: str = ""
+    last_sample: dict[str, JsonValue] = Field(default_factory=dict)
+    last_actions: list[dict[str, JsonValue]] = Field(default_factory=list)
+    updated_at: datetime = Field(default_factory=utc_now)
+
+
+def autoscaler_state_name(target_kind: AutoscalerTargetKind, target_id: str) -> str:
+    return f"{target_kind.value}:{target_id}"
+
+
+__all__ = [
+    "AutoscalerStateRecord",
+    "AutoscalerTargetKind",
+    "autoscaler_state_name",
+]