alter-sdk-github 0.2.1__py3-none-any.whl

alter_sdk_github/runtime.py

@@ -0,0 +1,135 @@
+"""Provider-owned response schemas bound to the selected contract version."""
+
+from functools import lru_cache
+from typing import Any, TypeVar
+
+from jsonschema import Draft202012Validator
+
+from alter_sdk.exceptions import BackendError, ManagedOperationError
+from alter_sdk.integrations import (
+    IntegrationCall as CoreCall,
+    IntegrationResult as CoreResult,
+    IntegrationClient,
+    ResponseContract,
+    IntegrationApprovalReference,
+)
+from alter_sdk.models import ApprovalResult, PendingApproval
+from alter_sdk_github.contracts import CONTRACT
+
+
+def has_fault(value: Any) -> bool:
+    if not isinstance(value, dict):
+        return False
+    if any(value.get(key) is not None for key in []) or any(
+        isinstance(value.get(key), list) and value[key] for key in []
+    ):
+        return True
+    for key in []:
+        children = value.get(key, [])
+        if not isinstance(children, list):
+            children = [children]
+        if any(has_fault(child) for child in children):
+            return True
+    return False
+
+
+FAULT_RULES = {}
+
+
+def matches_rule(value: Any, path: list[str], test: str, expected: Any = None) -> bool:
+    if not path:
+        if test == "equals":
+            return value == expected
+        return (
+            value is False
+            if test == "false"
+            else (value is not None and value is not False and value not in ("", [], {}))
+        )
+    head, *tail = path
+    if head == "**":
+        return (
+            isinstance(value, list)
+            and bool(value)
+            and all(matches_rule(item, tail, test, expected) for item in value)
+        )
+    if head == "*":
+        return isinstance(value, list) and any(
+            matches_rule(item, tail, test, expected) for item in value
+        )
+    return (
+        isinstance(value, dict)
+        and head in value
+        and matches_rule(value[head], tail, test, expected)
+    )
+
+
+@lru_cache
+def response_contract(operation: str, version: str) -> ResponseContract:
+    if version != CONTRACT["version"] or operation not in CONTRACT["operations"]:
+        raise BackendError("Selected managed response contract is not installed")
+    row = CONTRACT["operations"][operation]
+    validator = Draft202012Validator({**row["schema"], "$defs": CONTRACT["$defs"]})
+    return ResponseContract(
+        row["accept"],
+        validator.is_valid,
+        tuple(row.get("no_content_statuses", ())),
+        lambda value: (
+            has_fault(value)
+            or any(
+                matches_rule(value, rule["path"], rule["test"], rule.get("value"))
+                for rule in FAULT_RULES.get(operation, [])
+            )
+        ),
+    )
+
+
+T = TypeVar("T")
+
+
+class IntegrationCall(CoreCall[T]):
+    def __init__(
+        self,
+        client: IntegrationClient,
+        response: ApprovalResult | PendingApproval | IntegrationApprovalReference,
+        operation: str,
+        version: str,
+    ) -> None:
+        super().__init__(
+            client, response, operation, version, response_contract(operation, version)
+        )
+
+
+class IntegrationResult(CoreResult[T]):
+    def __init__(self, response: ApprovalResult, operation: str, version: str) -> None:
+        super().__init__(response, operation, version, response_contract(operation, version))
+
+
+async def resume_call(
+    client: IntegrationClient, approval_id: str, provider: str, version: str
+) -> IntegrationCall[Any]:
+    """Use the approval's server identity; never guess a decoder from the caller."""
+    resume = getattr(client.integrations, "resume", None)
+    if not callable(resume):
+        raise ManagedOperationError(
+            "managed_resume_unsupported",
+            "The installed core SDK does not support resuming managed approvals",
+            409,
+        )
+    call = await client.integrations.resume(approval_id)
+    if call.provider != provider or call.version != version:
+        raise ManagedOperationError(
+            "managed_approval_contract_mismatch",
+            "Approval belongs to a different provider or contract version",
+            409,
+        )
+    if call.operation not in CONTRACT["operations"]:
+        raise ManagedOperationError(
+            "managed_approval_operation_mismatch",
+            "Approval operation is absent from this installed publication",
+            409,
+        )
+    if call.approval_id is None:
+        raise BackendError("Resumed approval has no identity")
+    return IntegrationCall(
+        client, IntegrationApprovalReference(call.approval_id), call.operation, call.version
+    )

alter_sdk_github-0.2.1.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: alter-sdk-github
+Version: 0.2.1
+Summary: Typed github operations through Alter
+License-Expression: MIT
+License-File: LICENSE
+Author: Alter Team
+Author-email: founders@alterauth.com
+Requires-Python: >=3.11,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: alter-sdk (>=0.31.0,<0.32.0)
+Requires-Dist: jsonschema (>=4.26,<5)
+Description-Content-Type: text/markdown
+
+# alter-sdk-github
+
+Install `pip install alter-sdk-github`. Core `alter-sdk` is installed as a dependency.
+
+Import `GitHubIntegration` from `alter_sdk_github` and construct it with an Alter `App`
+and `{"grant_id": grant_id}`. All 1225 operations use
+immutable contract `2026-11-01`. Await `call.wait()` for immediate or
+approved execution, then decode with `result.body_json()`.
+OAuth and managed-secret/API-key grants use the same binding and controls when
+the provider supports that credential type.
+
+[Public API reference](https://docs.alterauth.com/reference/managed-github-operations) includes every operation's input/output fields and both SDK examples.
+
+
+## Resume after a process restart
+
+Persist the pending call's `approvalId` (TypeScript) or `approval_id` (Python)
+in your durable job record. After restarting, construct a fresh provider client:
+
+```typescript
+const resumed = await provider.resume(savedApprovalId);
+const result = await resumed.wait();
+const body = result.bodyJson();
+```
+
+```python
+resumed = await provider.resume(saved_approval_id)
+result = await resumed.wait()
+body = result.body_json()
+```
+
+The backend supplies the stored provider, operation and immutable contract version.
+The provider package verifies provider/version and applies that operation's validator
+and fault handling. Mismatches raise `ManagedOperationError` with
+`managed_approval_contract_mismatch` or `managed_approval_operation_mismatch`.
+The ID yields a union of operation outputs; TypeScript callers can narrow the call
+by `resumed.operation`. No operation or version is accepted from the caller.
+
+Generic `app.integrations.resume(id)` preserves raw response access and exact-number
+decoding; use the provider package for its response validator. Both use the existing
+approval poll's `proxy:execute` or `approvals:read` permissions and app/agent isolation.
+Resume also works after execution while the result is retained. Denial, expiry,
+execution failure and result purging retain the existing approval errors. Resume
+never resubmits the request. Raw approvals or missing stored identities fail with
+`managed_approval_identity_unavailable`.
+

alter_sdk_github-0.2.1.dist-info/RECORD

@@ -0,0 +1,32 @@
+alter_sdk_github/__init__.py,sha256=bgTFvbUR0fIm2h7U8acNASVd6Rff2bWa01NOAI_-XNo,220
+alter_sdk_github/_github_models_00.py,sha256=vd_zk972sSvEmE-keGhWEma-MdbcpOFUvgpO9IeG-UE,148019
+alter_sdk_github/_github_models_01.py,sha256=IjuNkbmwaDBvbQMbp-yNBgvBcFeQSNG7cX9EXdxZ0Q8,97687
+alter_sdk_github/_github_models_02.py,sha256=wu7FT9pYwVhCnlKx7oIrgtRjxZLHJNW5AAKxUhnR8W0,92059
+alter_sdk_github/_github_models_03.py,sha256=0Bdy2lEC7QL_YD4STQjKfdJlxc9Z-GUZ5Us-Tohq13s,172732
+alter_sdk_github/_github_models_04.py,sha256=aNtAHmBx4ychgRbYkL4WR14PqwC70m26aUyYq1n9kE4,105078
+alter_sdk_github/_github_models_05.py,sha256=QnErEsCSxDcBvUN45n70k6Gkc3KDVcNP7SAoZAwHu0w,102957
+alter_sdk_github/_github_models_06.py,sha256=fC-TDWdJYV5vqHNfLHL-QoZT3jZyi5ILjMtDz6FmcqE,82123
+alter_sdk_github/_github_models_07.py,sha256=fuoueJpMMr9OR6-ySJPDdWGdoRlUqKUJkJ-BS768_-Y,83204
+alter_sdk_github/_github_models_08.py,sha256=87uvhdB3amkMyQ3RjrzDUKxuxVSP-5TVsZP3RUIJ0fk,83409
+alter_sdk_github/_github_models_09.py,sha256=jURkrfwpkN6vli4IR9UI26xgpsd_TiBLOhRO5oZ0rwU,90531
+alter_sdk_github/_github_models_10.py,sha256=4GKkInAFENo9BJE92mYbQjR62flHawTYFN1SY3Xc-HA,80782
+alter_sdk_github/_github_models_11.py,sha256=9QVoSrPmPwwWEnFtar0_QdWoq_cXx75qUD5NLBidxfg,87748
+alter_sdk_github/_github_models_12.py,sha256=BwAiYmfhOUq7CqdRpDb_iOdxdMsYuiFwGWGABnEcPsI,85906
+alter_sdk_github/_github_models_13.py,sha256=IjQI4_pBf7D6mvoL-NiHLlhumIYVdZQeLiYAYSCbzQk,182647
+alter_sdk_github/_github_models_14.py,sha256=9dcapbkduHoi5FnVExjt0u2sMffGFrxiD_PbqvfgzaQ,194339
+alter_sdk_github/_github_models_15.py,sha256=Rn2keYaKw0zyN7_nDcq_B9BL8CaM-qKjKRJ6wHzAnfs,171003
+alter_sdk_github/_github_models_16.py,sha256=FQZULSe8esjDTSPrEpZwUa5jgVMDRbtabln8bJLygCs,168963
+alter_sdk_github/_github_models_17.py,sha256=cro2XGTe1Lk3Rp9xG85ymuscM-Vw0-N8hE8p0fdgsfs,279147
+alter_sdk_github/_github_models_18.py,sha256=CgEqfRQFI7KQRXZaT3osjM1oiR_bQUgfphU273Uaf48,328195
+alter_sdk_github/_github_models_19.py,sha256=jTxYguaSmXmc7eSKBqAtH7KItymfiZjZgUhQex1rGOA,360985
+alter_sdk_github/_github_models_20.py,sha256=jfhpLHSsk9JaOK_QgzW5pCyklqerdc5wH754vXt18-k,377453
+alter_sdk_github/_github_models_21.py,sha256=4VJpt2CYaZO5jJpqJvsrQ77tiu_wRwYYLohwzVazExY,295623
+alter_sdk_github/_github_models_22.py,sha256=iEJJjXh2dx9KmxFG27Ydq4O-JaSJhr8cXiD9wzObleg,70738
+alter_sdk_github/client.py,sha256=JJ4tIsDZhaZKUcTVDNnoNttGa6S8mWUIX95vgbWtLuQ,2396608
+alter_sdk_github/contracts.py,sha256=16kD0w8l06YlZVwA1pwMMfL55a3QWxSqIWzpz2pSX-s,1303172
+alter_sdk_github/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alter_sdk_github/runtime.py,sha256=FlxrumVStoCYLGk2Q8uzoIVAzr9aHRVL-TcUM7UGfIY,4541
+alter_sdk_github-0.2.1.dist-info/METADATA,sha256=vLySWQxhFiCkUjTO3I9AVJec4i46PTEDXieGbiTNm5M,2757
+alter_sdk_github-0.2.1.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
+alter_sdk_github-0.2.1.dist-info/licenses/LICENSE,sha256=r0DtRu8742Pi6xbXALkRMtxlltqEQQ-cpgaWOAKts6w,1071
+alter_sdk_github-0.2.1.dist-info/RECORD,,

alter_sdk_github-0.2.1.dist-info/WHEEL

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

alter_sdk_github-0.2.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alter AI, Inc.
+
+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.