PyPI - cap-sdk-python - Versions diffs - 2.0.19__tar.gz → 2.5.2__tar.gz - Mend

cap-sdk-python 2.0.19tar.gz → 2.5.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (37) hide show

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/PKG-INFO RENAMED Viewed

@@ -1,8 +1,13 @@
 Metadata-Version: 2.4
 Name: cap-sdk-python
-Version: 2.0.19
+Version: 2.5.2
 Summary: CAP (Cordum Agent Protocol) Python SDK
+Author-email: Cordum <eng@cordum.io>
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/cordum-io/cap
+Project-URL: Repository, https://github.com/cordum-io/cap
+Project-URL: Issues, https://github.com/cordum-io/cap/issues
+Keywords: cap,cordum,agent,protocol,sdk,ai
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: protobuf>=4.25.0

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/__init__.py RENAMED Viewed

@@ -27,6 +27,23 @@ from .client import submit_job
 from .worker import run_worker
 from .bus import connect_nats
 from .runtime import Agent, Context, BlobStore, RedisBlobStore, InMemoryBlobStore
+from .validate import (
+    ValidationError,
+    validate_job_request,
+    validate_job_result,
+    validate_bus_packet,
+)
+from .subjects import (
+    SUBJECT_SUBMIT,
+    SUBJECT_RESULT,
+    SUBJECT_HEARTBEAT,
+    SUBJECT_ALERT,
+    SUBJECT_PROGRESS,
+    SUBJECT_CANCEL,
+    SUBJECT_DLQ,
+    SUBJECT_WORKFLOW_EVENT,
+    SUBJECT_HANDSHAKE,
+)
 __all__ = [
     "submit_job",
@@ -37,4 +54,17 @@ __all__ = [
     "BlobStore",
     "RedisBlobStore",
     "InMemoryBlobStore",
+    "ValidationError",
+    "validate_job_request",
+    "validate_job_result",
+    "validate_bus_packet",
+    "SUBJECT_SUBMIT",
+    "SUBJECT_RESULT",
+    "SUBJECT_HEARTBEAT",
+    "SUBJECT_ALERT",
+    "SUBJECT_PROGRESS",
+    "SUBJECT_CANCEL",
+    "SUBJECT_DLQ",
+    "SUBJECT_WORKFLOW_EVENT",
+    "SUBJECT_HANDSHAKE",
 ]

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/client.py RENAMED Viewed

@@ -5,8 +5,9 @@ from cryptography.hazmat.primitives import hashes
 from typing import Optional
+from cap.subjects import SUBJECT_SUBMIT
 DEFAULT_PROTOCOL_VERSION = 1
-SUBJECT_SUBMIT = "sys.job.submit"
 async def submit_job(

cap_sdk_python-2.5.2/cap/pb/cordum/agent/v1/alert_pb2.py ADDED Viewed

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: cordum/agent/v1/alert.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'cordum/agent/v1/alert.proto'
+)
+# @@protoc_insertion_point(imports)
+_sym_db = _symbol_database.Default()
+from cordum.agent.v1 import job_pb2 as cordum_dot_agent_dot_v1_dot_job__pb2
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1b\x63ordum/agent/v1/alert.proto\x12\x0f\x63ordum.agent.v1\x1a\x19\x63ordum/agent/v1/job.proto\"\xcd\x02\n\x0bSystemAlert\x12\r\n\x05level\x18\x01 \x01(\t\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x11\n\tcomponent\x18\x03 \x01(\t\x12\x0c\n\x04\x63ode\x18\x04 \x01(\t\x12\x30\n\x08severity\x18\x05 \x01(\x0e\x32\x1e.cordum.agent.v1.AlertSeverity\x12\x33\n\x0f\x65rror_code_enum\x18\x06 \x01(\x0e\x32\x1a.cordum.agent.v1.ErrorCode\x12\x18\n\x10source_component\x18\x07 \x01(\t\x12:\n\x07\x64\x65tails\x18\x08 \x03(\x0b\x32).cordum.agent.v1.SystemAlert.DetailsEntry\x12\x10\n\x08trace_id\x18\t \x01(\t\x1a.\n\x0c\x44\x65tailsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01*\x9b\x01\n\rAlertSeverity\x12\x1e\n\x1a\x41LERT_SEVERITY_UNSPECIFIED\x10\x00\x12\x17\n\x13\x41LERT_SEVERITY_INFO\x10\x01\x12\x1a\n\x16\x41LERT_SEVERITY_WARNING\x10\x02\x12\x18\n\x14\x41LERT_SEVERITY_ERROR\x10\x03\x12\x1b\n\x17\x41LERT_SEVERITY_CRITICAL\x10\x04\x42\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'cordum.agent.v1.alert_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\026io.cordum.cap.agent.v1P\001Z+github.com/cordum-io/cap/v2/cordum/agent/v1\252\002\017Cordum.Agent.V1\312\002\017cordum\\Agent\\V1\352\002\021Cordum::Agent::V1'
+  _globals['_SYSTEMALERT_DETAILSENTRY']._loaded_options = None
+  _globals['_SYSTEMALERT_DETAILSENTRY']._serialized_options = b'8\001'
+  _globals['_ALERTSEVERITY']._serialized_start=412
+  _globals['_ALERTSEVERITY']._serialized_end=567
+  _globals['_SYSTEMALERT']._serialized_start=76
+  _globals['_SYSTEMALERT']._serialized_end=409
+  _globals['_SYSTEMALERT_DETAILSENTRY']._serialized_start=363
+  _globals['_SYSTEMALERT_DETAILSENTRY']._serialized_end=409
+# @@protoc_insertion_point(module_scope)

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/alert_pb2_grpc.py RENAMED Viewed

@@ -4,7 +4,7 @@ import grpc
 import warnings
-GRPC_GENERATED_VERSION = '1.76.0'
+GRPC_GENERATED_VERSION = '1.78.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/buspacket_pb2.py RENAMED Viewed

@@ -26,9 +26,10 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from cordum.agent.v1 import job_pb2 as cordum_dot_agent_dot_v1_dot_job__pb2
 from cordum.agent.v1 import heartbeat_pb2 as cordum_dot_agent_dot_v1_dot_heartbeat__pb2
 from cordum.agent.v1 import alert_pb2 as cordum_dot_agent_dot_v1_dot_alert__pb2
+from cordum.agent.v1 import handshake_pb2 as cordum_dot_agent_dot_v1_dot_handshake__pb2
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1f\x63ordum/agent/v1/buspacket.proto\x12\x0f\x63ordum.agent.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x19\x63ordum/agent/v1/job.proto\x1a\x1f\x63ordum/agent/v1/heartbeat.proto\x1a\x1b\x63ordum/agent/v1/alert.proto\"\xc6\x03\n\tBusPacket\x12\x10\n\x08trace_id\x18\x01 \x01(\t\x12\x11\n\tsender_id\x18\x02 \x01(\t\x12.\n\ncreated_at\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x18\n\x10protocol_version\x18\x04 \x01(\x05\x12\x32\n\x0bjob_request\x18\n \x01(\x0b\x32\x1b.cordum.agent.v1.JobRequestH\x00\x12\x30\n\njob_result\x18\x0b \x01(\x0b\x32\x1a.cordum.agent.v1.JobResultH\x00\x12/\n\theartbeat\x18\x0c \x01(\x0b\x32\x1a.cordum.agent.v1.HeartbeatH\x00\x12-\n\x05\x61lert\x18\r \x01(\x0b\x32\x1c.cordum.agent.v1.SystemAlertH\x00\x12\x34\n\x0cjob_progress\x18\x0f \x01(\x0b\x32\x1c.cordum.agent.v1.JobProgressH\x00\x12\x30\n\njob_cancel\x18\x10 \x01(\x0b\x32\x1a.cordum.agent.v1.JobCancelH\x00\x12\x11\n\tsignature\x18\x0e \x01(\x0c\x42\t\n\x07payloadB\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1f\x63ordum/agent/v1/buspacket.proto\x12\x0f\x63ordum.agent.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x19\x63ordum/agent/v1/job.proto\x1a\x1f\x63ordum/agent/v1/heartbeat.proto\x1a\x1b\x63ordum/agent/v1/alert.proto\x1a\x1f\x63ordum/agent/v1/handshake.proto\"\xf7\x03\n\tBusPacket\x12\x10\n\x08trace_id\x18\x01 \x01(\t\x12\x11\n\tsender_id\x18\x02 \x01(\t\x12.\n\ncreated_at\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x18\n\x10protocol_version\x18\x04 \x01(\x05\x12\x32\n\x0bjob_request\x18\n \x01(\x0b\x32\x1b.cordum.agent.v1.JobRequestH\x00\x12\x30\n\njob_result\x18\x0b \x01(\x0b\x32\x1a.cordum.agent.v1.JobResultH\x00\x12/\n\theartbeat\x18\x0c \x01(\x0b\x32\x1a.cordum.agent.v1.HeartbeatH\x00\x12-\n\x05\x61lert\x18\r \x01(\x0b\x32\x1c.cordum.agent.v1.SystemAlertH\x00\x12\x34\n\x0cjob_progress\x18\x0f \x01(\x0b\x32\x1c.cordum.agent.v1.JobProgressH\x00\x12\x30\n\njob_cancel\x18\x10 \x01(\x0b\x32\x1a.cordum.agent.v1.JobCancelH\x00\x12/\n\thandshake\x18\x11 \x01(\x0b\x32\x1a.cordum.agent.v1.HandshakeH\x00\x12\x11\n\tsignature\x18\x0e \x01(\x0c\x42\t\n\x07payloadB\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -36,6 +37,6 @@ _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'cordum.agent.v1.buspacket_p
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'\n\026io.cordum.cap.agent.v1P\001Z+github.com/cordum-io/cap/v2/cordum/agent/v1\252\002\017Cordum.Agent.V1\312\002\017cordum\\Agent\\V1\352\002\021Cordum::Agent::V1'
-  _globals['_BUSPACKET']._serialized_start=175
-  _globals['_BUSPACKET']._serialized_end=629
+  _globals['_BUSPACKET']._serialized_start=208
+  _globals['_BUSPACKET']._serialized_end=711
 # @@protoc_insertion_point(module_scope)

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/buspacket_pb2_grpc.py RENAMED Viewed

@@ -4,7 +4,7 @@ import grpc
 import warnings
-GRPC_GENERATED_VERSION = '1.76.0'
+GRPC_GENERATED_VERSION = '1.78.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False

cap_sdk_python-2.5.2/cap/pb/cordum/agent/v1/handshake_pb2.py ADDED Viewed

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: cordum/agent/v1/handshake.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'cordum/agent/v1/handshake.proto'
+)
+# @@protoc_insertion_point(imports)
+_sym_db = _symbol_database.Default()
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1f\x63ordum/agent/v1/handshake.proto\x12\x0f\x63ordum.agent.v1\"\xf9\x01\n\tHandshake\x12\x14\n\x0c\x63omponent_id\x18\x01 \x01(\t\x12,\n\x04role\x18\x02 \x01(\x0e\x32\x1e.cordum.agent.v1.ComponentRole\x12\x1a\n\x12supported_versions\x18\x03 \x03(\x05\x12\x42\n\x0c\x63\x61pabilities\x18\x04 \x03(\x0b\x32,.cordum.agent.v1.Handshake.CapabilitiesEntry\x12\x13\n\x0bsdk_version\x18\x05 \x01(\t\x1a\x33\n\x11\x43\x61pabilitiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x08:\x02\x38\x01*\xc4\x01\n\rComponentRole\x12\x1e\n\x1a\x43OMPONENT_ROLE_UNSPECIFIED\x10\x00\x12\x1a\n\x16\x43OMPONENT_ROLE_GATEWAY\x10\x01\x12\x1c\n\x18\x43OMPONENT_ROLE_SCHEDULER\x10\x02\x12\x19\n\x15\x43OMPONENT_ROLE_WORKER\x10\x03\x12\x1f\n\x1b\x43OMPONENT_ROLE_ORCHESTRATOR\x10\x04\x12\x1d\n\x19\x43OMPONENT_ROLE_CONTROLLER\x10\x05\x42\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'cordum.agent.v1.handshake_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\026io.cordum.cap.agent.v1P\001Z+github.com/cordum-io/cap/v2/cordum/agent/v1\252\002\017Cordum.Agent.V1\312\002\017cordum\\Agent\\V1\352\002\021Cordum::Agent::V1'
+  _globals['_HANDSHAKE_CAPABILITIESENTRY']._loaded_options = None
+  _globals['_HANDSHAKE_CAPABILITIESENTRY']._serialized_options = b'8\001'
+  _globals['_COMPONENTROLE']._serialized_start=305
+  _globals['_COMPONENTROLE']._serialized_end=501
+  _globals['_HANDSHAKE']._serialized_start=53
+  _globals['_HANDSHAKE']._serialized_end=302
+  _globals['_HANDSHAKE_CAPABILITIESENTRY']._serialized_start=251
+  _globals['_HANDSHAKE_CAPABILITIESENTRY']._serialized_end=302
+# @@protoc_insertion_point(module_scope)

cap_sdk_python-2.5.2/cap/pb/cordum/agent/v1/handshake_pb2_grpc.py ADDED Viewed

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+GRPC_GENERATED_VERSION = '1.78.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in cordum/agent/v1/handshake_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/heartbeat_pb2_grpc.py RENAMED Viewed

@@ -4,7 +4,7 @@ import grpc
 import warnings
-GRPC_GENERATED_VERSION = '1.76.0'
+GRPC_GENERATED_VERSION = '1.78.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/job_pb2.py RENAMED Viewed

@@ -24,7 +24,7 @@ _sym_db = _symbol_database.Default()
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x19\x63ordum/agent/v1/job.proto\x12\x0f\x63ordum.agent.v1\"l\n\x0c\x43ontextHints\x12\x18\n\x10max_input_tokens\x18\x01 \x01(\x05\x12\x1b\n\x13\x61llow_summarization\x18\x02 \x01(\x08\x12\x17\n\x0f\x61llow_retrieval\x18\x03 \x01(\x08\x12\x0c\n\x04tags\x18\x04 \x03(\t\"l\n\x06\x42udget\x12\x18\n\x10max_input_tokens\x18\x01 \x01(\x03\x12\x19\n\x11max_output_tokens\x18\x02 \x01(\x03\x12\x18\n\x10max_total_tokens\x18\x03 \x01(\x03\x12\x13\n\x0b\x64\x65\x61\x64line_ms\x18\x04 \x01(\x03\"\xae\x02\n\x0bJobMetadata\x12\x11\n\ttenant_id\x18\x01 \x01(\t\x12\x10\n\x08\x61\x63tor_id\x18\x02 \x01(\t\x12.\n\nactor_type\x18\x03 \x01(\x0e\x32\x1a.cordum.agent.v1.ActorType\x12\x17\n\x0fidempotency_key\x18\x04 \x01(\t\x12\x12\n\ncapability\x18\x05 \x01(\t\x12\x11\n\trisk_tags\x18\x06 \x03(\t\x12\x10\n\x08requires\x18\x07 \x03(\t\x12\x0f\n\x07pack_id\x18\x08 \x01(\t\x12\x38\n\x06labels\x18\t \x03(\x0b\x32(.cordum.agent.v1.JobMetadata.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x88\x04\n\x0c\x43ompensation\x12\r\n\x05topic\x18\x01 \x01(\t\x12\x13\n\x0b\x63ontext_ptr\x18\x02 \x01(\t\x12.\n\x08priority\x18\x03 \x01(\x0e\x32\x1c.cordum.agent.v1.JobPriority\x12\x12\n\nadapter_id\x18\x04 \x01(\t\x12\x33\n\x03\x65nv\x18\x05 \x03(\x0b\x32&.cordum.agent.v1.Compensation.EnvEntry\x12\x11\n\tmemory_id\x18\x06 \x01(\t\x12\x34\n\rcontext_hints\x18\x07 \x01(\x0b\x32\x1d.cordum.agent.v1.ContextHints\x12\'\n\x06\x62udget\x18\x08 \x01(\x0b\x32\x17.cordum.agent.v1.Budget\x12\x11\n\ttenant_id\x18\t \x01(\t\x12\x14\n\x0cprincipal_id\x18\n \x01(\t\x12\x39\n\x06labels\x18\x0b \x03(\x0b\x32).cordum.agent.v1.Compensation.LabelsEntry\x12*\n\x04meta\x18\x0c \x01(\x0b\x32\x1c.cordum.agent.v1.JobMetadata\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x87\x05\n\nJobRequest\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\r\n\x05topic\x18\x02 \x01(\t\x12.\n\x08priority\x18\x03 \x01(\x0e\x32\x1c.cordum.agent.v1.JobPriority\x12\x13\n\x0b\x63ontext_ptr\x18\x04 \x01(\t\x12\x12\n\nadapter_id\x18\x05 \x01(\t\x12\x31\n\x03\x65nv\x18\x06 \x03(\x0b\x32$.cordum.agent.v1.JobRequest.EnvEntry\x12\x15\n\rparent_job_id\x18\x07 \x01(\t\x12\x13\n\x0bworkflow_id\x18\x08 \x01(\t\x12\x12\n\nstep_index\x18\t \x01(\x05\x12\x11\n\tmemory_id\x18\n \x01(\t\x12\x34\n\rcontext_hints\x18\x0b \x01(\x0b\x32\x1d.cordum.agent.v1.ContextHints\x12\'\n\x06\x62udget\x18\x0c \x01(\x0b\x32\x17.cordum.agent.v1.Budget\x12\x11\n\ttenant_id\x18\r \x01(\t\x12\x14\n\x0cprincipal_id\x18\x0e \x01(\t\x12\x37\n\x06labels\x18\x0f \x03(\x0b\x32\'.cordum.agent.v1.JobRequest.LabelsEntry\x12*\n\x04meta\x18\x10 \x01(\x0b\x32\x1c.cordum.agent.v1.JobMetadata\x12\x33\n\x0c\x63ompensation\x18\x11 \x01(\x0b\x32\x1d.cordum.agent.v1.Compensation\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xc6\x01\n\tJobResult\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12*\n\x06status\x18\x02 \x01(\x0e\x32\x1a.cordum.agent.v1.JobStatus\x12\x12\n\nresult_ptr\x18\x03 \x01(\t\x12\x11\n\tworker_id\x18\x04 \x01(\t\x12\x14\n\x0c\x65xecution_ms\x18\x05 \x01(\x03\x12\x12\n\nerror_code\x18\x06 \x01(\t\x12\x15\n\rerror_message\x18\x07 \x01(\t\x12\x15\n\rartifact_ptrs\x18\x08 \x03(\t\"\xa7\x01\n\x0bJobProgress\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\x0f\n\x07step_id\x18\x02 \x01(\t\x12\x0f\n\x07percent\x18\x03 \x01(\x05\x12\x0f\n\x07message\x18\x04 \x01(\t\x12\x12\n\nresult_ptr\x18\x05 \x01(\t\x12\x15\n\rartifact_ptrs\x18\x06 \x03(\t\x12*\n\x06status\x18\x07 \x01(\x0e\x32\x1a.cordum.agent.v1.JobStatus\"A\n\tJobCancel\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\x0e\n\x06reason\x18\x02 \x01(\t\x12\x14\n\x0crequested_by\x18\x03 \x01(\t*|\n\x0bJobPriority\x12\x1c\n\x18JOB_PRIORITY_UNSPECIFIED\x10\x00\x12\x1c\n\x18JOB_PRIORITY_INTERACTIVE\x10\x01\x12\x16\n\x12JOB_PRIORITY_BATCH\x10\x02\x12\x19\n\x15JOB_PRIORITY_CRITICAL\x10\x03*\xc4\x02\n\tJobStatus\x12\x1a\n\x16JOB_STATUS_UNSPECIFIED\x10\x00\x12\x16\n\x12JOB_STATUS_PENDING\x10\x01\x12\x18\n\x14JOB_STATUS_SCHEDULED\x10\x02\x12\x19\n\x15JOB_STATUS_DISPATCHED\x10\x03\x12\x16\n\x12JOB_STATUS_RUNNING\x10\x04\x12\x18\n\x14JOB_STATUS_SUCCEEDED\x10\x05\x12\x15\n\x11JOB_STATUS_FAILED\x10\x06\x12\x18\n\x14JOB_STATUS_CANCELLED\x10\x07\x12\x15\n\x11JOB_STATUS_DENIED\x10\x08\x12\x16\n\x12JOB_STATUS_TIMEOUT\x10\t\x12\x1f\n\x1bJOB_STATUS_FAILED_RETRYABLE\x10\n\x12\x1b\n\x17JOB_STATUS_FAILED_FATAL\x10\x0b*U\n\tActorType\x12\x1a\n\x16\x41\x43TOR_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10\x41\x43TOR_TYPE_HUMAN\x10\x01\x12\x16\n\x12\x41\x43TOR_TYPE_SERVICE\x10\x02\x42\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x19\x63ordum/agent/v1/job.proto\x12\x0f\x63ordum.agent.v1\"l\n\x0c\x43ontextHints\x12\x18\n\x10max_input_tokens\x18\x01 \x01(\x05\x12\x1b\n\x13\x61llow_summarization\x18\x02 \x01(\x08\x12\x17\n\x0f\x61llow_retrieval\x18\x03 \x01(\x08\x12\x0c\n\x04tags\x18\x04 \x03(\t\"l\n\x06\x42udget\x12\x18\n\x10max_input_tokens\x18\x01 \x01(\x03\x12\x19\n\x11max_output_tokens\x18\x02 \x01(\x03\x12\x18\n\x10max_total_tokens\x18\x03 \x01(\x03\x12\x13\n\x0b\x64\x65\x61\x64line_ms\x18\x04 \x01(\x03\"\xae\x02\n\x0bJobMetadata\x12\x11\n\ttenant_id\x18\x01 \x01(\t\x12\x10\n\x08\x61\x63tor_id\x18\x02 \x01(\t\x12.\n\nactor_type\x18\x03 \x01(\x0e\x32\x1a.cordum.agent.v1.ActorType\x12\x17\n\x0fidempotency_key\x18\x04 \x01(\t\x12\x12\n\ncapability\x18\x05 \x01(\t\x12\x11\n\trisk_tags\x18\x06 \x03(\t\x12\x10\n\x08requires\x18\x07 \x03(\t\x12\x0f\n\x07pack_id\x18\x08 \x01(\t\x12\x38\n\x06labels\x18\t \x03(\x0b\x32(.cordum.agent.v1.JobMetadata.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x88\x04\n\x0c\x43ompensation\x12\r\n\x05topic\x18\x01 \x01(\t\x12\x13\n\x0b\x63ontext_ptr\x18\x02 \x01(\t\x12.\n\x08priority\x18\x03 \x01(\x0e\x32\x1c.cordum.agent.v1.JobPriority\x12\x12\n\nadapter_id\x18\x04 \x01(\t\x12\x33\n\x03\x65nv\x18\x05 \x03(\x0b\x32&.cordum.agent.v1.Compensation.EnvEntry\x12\x11\n\tmemory_id\x18\x06 \x01(\t\x12\x34\n\rcontext_hints\x18\x07 \x01(\x0b\x32\x1d.cordum.agent.v1.ContextHints\x12\'\n\x06\x62udget\x18\x08 \x01(\x0b\x32\x17.cordum.agent.v1.Budget\x12\x11\n\ttenant_id\x18\t \x01(\t\x12\x14\n\x0cprincipal_id\x18\n \x01(\t\x12\x39\n\x06labels\x18\x0b \x03(\x0b\x32).cordum.agent.v1.Compensation.LabelsEntry\x12*\n\x04meta\x18\x0c \x01(\x0b\x32\x1c.cordum.agent.v1.JobMetadata\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x87\x05\n\nJobRequest\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\r\n\x05topic\x18\x02 \x01(\t\x12.\n\x08priority\x18\x03 \x01(\x0e\x32\x1c.cordum.agent.v1.JobPriority\x12\x13\n\x0b\x63ontext_ptr\x18\x04 \x01(\t\x12\x12\n\nadapter_id\x18\x05 \x01(\t\x12\x31\n\x03\x65nv\x18\x06 \x03(\x0b\x32$.cordum.agent.v1.JobRequest.EnvEntry\x12\x15\n\rparent_job_id\x18\x07 \x01(\t\x12\x13\n\x0bworkflow_id\x18\x08 \x01(\t\x12\x12\n\nstep_index\x18\t \x01(\x05\x12\x11\n\tmemory_id\x18\n \x01(\t\x12\x34\n\rcontext_hints\x18\x0b \x01(\x0b\x32\x1d.cordum.agent.v1.ContextHints\x12\'\n\x06\x62udget\x18\x0c \x01(\x0b\x32\x17.cordum.agent.v1.Budget\x12\x11\n\ttenant_id\x18\r \x01(\t\x12\x14\n\x0cprincipal_id\x18\x0e \x01(\t\x12\x37\n\x06labels\x18\x0f \x03(\x0b\x32\'.cordum.agent.v1.JobRequest.LabelsEntry\x12*\n\x04meta\x18\x10 \x01(\x0b\x32\x1c.cordum.agent.v1.JobMetadata\x12\x33\n\x0c\x63ompensation\x18\x11 \x01(\x0b\x32\x1d.cordum.agent.v1.Compensation\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xfb\x01\n\tJobResult\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12*\n\x06status\x18\x02 \x01(\x0e\x32\x1a.cordum.agent.v1.JobStatus\x12\x12\n\nresult_ptr\x18\x03 \x01(\t\x12\x11\n\tworker_id\x18\x04 \x01(\t\x12\x14\n\x0c\x65xecution_ms\x18\x05 \x01(\x03\x12\x12\n\nerror_code\x18\x06 \x01(\t\x12\x15\n\rerror_message\x18\x07 \x01(\t\x12\x15\n\rartifact_ptrs\x18\x08 \x03(\t\x12\x33\n\x0f\x65rror_code_enum\x18\t \x01(\x0e\x32\x1a.cordum.agent.v1.ErrorCode\"\xa7\x01\n\x0bJobProgress\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\x0f\n\x07step_id\x18\x02 \x01(\t\x12\x0f\n\x07percent\x18\x03 \x01(\x05\x12\x0f\n\x07message\x18\x04 \x01(\t\x12\x12\n\nresult_ptr\x18\x05 \x01(\t\x12\x15\n\rartifact_ptrs\x18\x06 \x03(\t\x12*\n\x06status\x18\x07 \x01(\x0e\x32\x1a.cordum.agent.v1.JobStatus\"A\n\tJobCancel\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\x0e\n\x06reason\x18\x02 \x01(\t\x12\x14\n\x0crequested_by\x18\x03 \x01(\t*|\n\x0bJobPriority\x12\x1c\n\x18JOB_PRIORITY_UNSPECIFIED\x10\x00\x12\x1c\n\x18JOB_PRIORITY_INTERACTIVE\x10\x01\x12\x16\n\x12JOB_PRIORITY_BATCH\x10\x02\x12\x19\n\x15JOB_PRIORITY_CRITICAL\x10\x03*\xc4\x02\n\tJobStatus\x12\x1a\n\x16JOB_STATUS_UNSPECIFIED\x10\x00\x12\x16\n\x12JOB_STATUS_PENDING\x10\x01\x12\x18\n\x14JOB_STATUS_SCHEDULED\x10\x02\x12\x19\n\x15JOB_STATUS_DISPATCHED\x10\x03\x12\x16\n\x12JOB_STATUS_RUNNING\x10\x04\x12\x18\n\x14JOB_STATUS_SUCCEEDED\x10\x05\x12\x15\n\x11JOB_STATUS_FAILED\x10\x06\x12\x18\n\x14JOB_STATUS_CANCELLED\x10\x07\x12\x15\n\x11JOB_STATUS_DENIED\x10\x08\x12\x16\n\x12JOB_STATUS_TIMEOUT\x10\t\x12\x1f\n\x1bJOB_STATUS_FAILED_RETRYABLE\x10\n\x12\x1b\n\x17JOB_STATUS_FAILED_FATAL\x10\x0b*U\n\tActorType\x12\x1a\n\x16\x41\x43TOR_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10\x41\x43TOR_TYPE_HUMAN\x10\x01\x12\x16\n\x12\x41\x43TOR_TYPE_SERVICE\x10\x02*\xe1\x05\n\tErrorCode\x12\x1a\n\x16\x45RROR_CODE_UNSPECIFIED\x10\x00\x12(\n$ERROR_CODE_PROTOCOL_VERSION_MISMATCH\x10\x64\x12(\n$ERROR_CODE_PROTOCOL_MALFORMED_PACKET\x10\x65\x12\'\n#ERROR_CODE_PROTOCOL_UNKNOWN_PAYLOAD\x10\x66\x12)\n%ERROR_CODE_PROTOCOL_SIGNATURE_INVALID\x10g\x12)\n%ERROR_CODE_PROTOCOL_SIGNATURE_MISSING\x10h\x12\x1b\n\x16\x45RROR_CODE_JOB_TIMEOUT\x10\xc8\x01\x12&\n!ERROR_CODE_JOB_RESOURCE_EXHAUSTED\x10\xc9\x01\x12%\n ERROR_CODE_JOB_PERMISSION_DENIED\x10\xca\x01\x12!\n\x1c\x45RROR_CODE_JOB_INVALID_INPUT\x10\xcb\x01\x12\x1d\n\x18\x45RROR_CODE_JOB_NOT_FOUND\x10\xcc\x01\x12\x1d\n\x18\x45RROR_CODE_JOB_DUPLICATE\x10\xcd\x01\x12&\n!ERROR_CODE_JOB_WORKER_UNAVAILABLE\x10\xce\x01\x12\x1d\n\x18\x45RROR_CODE_SAFETY_DENIED\x10\xac\x02\x12\'\n\"ERROR_CODE_SAFETY_POLICY_VIOLATION\x10\xad\x02\x12\'\n\"ERROR_CODE_SAFETY_RISK_TAG_BLOCKED\x10\xae\x02\x12(\n#ERROR_CODE_TRANSPORT_PUBLISH_FAILED\x10\x90\x03\x12*\n%ERROR_CODE_TRANSPORT_SUBSCRIBE_FAILED\x10\x91\x03\x12)\n$ERROR_CODE_TRANSPORT_CONNECTION_LOST\x10\x92\x03\x42\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -42,12 +42,14 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_JOBREQUEST_ENVENTRY']._serialized_options = b'8\001'
   _globals['_JOBREQUEST_LABELSENTRY']._loaded_options = None
   _globals['_JOBREQUEST_LABELSENTRY']._serialized_options = b'8\001'
-  _globals['_JOBPRIORITY']._serialized_start=2182
-  _globals['_JOBPRIORITY']._serialized_end=2306
-  _globals['_JOBSTATUS']._serialized_start=2309
-  _globals['_JOBSTATUS']._serialized_end=2633
-  _globals['_ACTORTYPE']._serialized_start=2635
-  _globals['_ACTORTYPE']._serialized_end=2720
+  _globals['_JOBPRIORITY']._serialized_start=2235
+  _globals['_JOBPRIORITY']._serialized_end=2359
+  _globals['_JOBSTATUS']._serialized_start=2362
+  _globals['_JOBSTATUS']._serialized_end=2686
+  _globals['_ACTORTYPE']._serialized_start=2688
+  _globals['_ACTORTYPE']._serialized_end=2773
+  _globals['_ERRORCODE']._serialized_start=2776
+  _globals['_ERRORCODE']._serialized_end=3513
   _globals['_CONTEXTHINTS']._serialized_start=46
   _globals['_CONTEXTHINTS']._serialized_end=154
   _globals['_BUDGET']._serialized_start=156
@@ -69,9 +71,9 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_JOBREQUEST_LABELSENTRY']._serialized_start=524
   _globals['_JOBREQUEST_LABELSENTRY']._serialized_end=569
   _globals['_JOBRESULT']._serialized_start=1745
-  _globals['_JOBRESULT']._serialized_end=1943
-  _globals['_JOBPROGRESS']._serialized_start=1946
-  _globals['_JOBPROGRESS']._serialized_end=2113
-  _globals['_JOBCANCEL']._serialized_start=2115
-  _globals['_JOBCANCEL']._serialized_end=2180
+  _globals['_JOBRESULT']._serialized_end=1996
+  _globals['_JOBPROGRESS']._serialized_start=1999
+  _globals['_JOBPROGRESS']._serialized_end=2166
+  _globals['_JOBCANCEL']._serialized_start=2168
+  _globals['_JOBCANCEL']._serialized_end=2233
 # @@protoc_insertion_point(module_scope)

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/job_pb2_grpc.py RENAMED Viewed

@@ -4,7 +4,7 @@ import grpc
 import warnings
-GRPC_GENERATED_VERSION = '1.76.0'
+GRPC_GENERATED_VERSION = '1.78.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/pb/cordum/agent/v1/safety_pb2_grpc.py RENAMED Viewed

@@ -5,7 +5,7 @@ import warnings
 from cordum.agent.v1 import safety_pb2 as cordum_dot_agent_dot_v1_dot_safety__pb2
-GRPC_GENERATED_VERSION = '1.76.0'
+GRPC_GENERATED_VERSION = '1.78.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/runtime.py RENAMED Viewed

@@ -23,8 +23,9 @@ except Exception:  # pragma: no cover - optional until runtime used
     ValidationError = Exception
+from cap.subjects import SUBJECT_RESULT
 DEFAULT_PROTOCOL_VERSION = 1
-SUBJECT_RESULT = "sys.job.result"
 class BlobStore(Protocol):

cap_sdk_python-2.5.2/cap/subjects.py ADDED Viewed

@@ -0,0 +1,9 @@
+SUBJECT_SUBMIT = "sys.job.submit"
+SUBJECT_RESULT = "sys.job.result"
+SUBJECT_HEARTBEAT = "sys.heartbeat"
+SUBJECT_ALERT = "sys.alert"
+SUBJECT_PROGRESS = "sys.job.progress"
+SUBJECT_CANCEL = "sys.job.cancel"
+SUBJECT_DLQ = "sys.job.dlq"
+SUBJECT_WORKFLOW_EVENT = "sys.workflow.event"
+SUBJECT_HANDSHAKE = "sys.handshake"

cap_sdk_python-2.5.2/cap/validate.py ADDED Viewed

@@ -0,0 +1,105 @@
+"""Opt-in validation helpers for CAP protobuf messages.
+Each function accepts a protobuf message object and returns a list of
+ValidationError instances.  An empty list means the message is valid.
+"""
+from dataclasses import dataclass
+from typing import Any, List
+from cap.pb.cordum.agent.v1 import buspacket_pb2, job_pb2
+# Max known JobPriority enum value.
+_JOB_PRIORITY_MAX = job_pb2.JOB_PRIORITY_CRITICAL  # 3
+@dataclass(frozen=True)
+class ValidationError:
+    """A single validation failure."""
+    field: str
+    message: str
+def validate_job_request(msg: Any) -> List[ValidationError]:
+    """Validate semantic constraints on a JobRequest."""
+    errors: List[ValidationError] = []
+    if msg is None:
+        errors.append(ValidationError("JobRequest", "must not be nil"))
+        return errors
+    if not msg.job_id:
+        errors.append(ValidationError("job_id", "must not be empty"))
+    if not msg.topic:
+        errors.append(ValidationError("topic", "must not be empty"))
+    if msg.priority < 0 or msg.priority > _JOB_PRIORITY_MAX:
+        errors.append(
+            ValidationError("priority", f"invalid value {msg.priority}")
+        )
+    if msg.step_index < 0:
+        errors.append(ValidationError("step_index", "must not be negative"))
+    if msg.HasField("budget"):
+        b = msg.budget
+        if b.max_input_tokens < 0:
+            errors.append(
+                ValidationError("budget.max_input_tokens", "must not be negative")
+            )
+        if b.max_output_tokens < 0:
+            errors.append(
+                ValidationError("budget.max_output_tokens", "must not be negative")
+            )
+        if b.max_total_tokens < 0:
+            errors.append(
+                ValidationError("budget.max_total_tokens", "must not be negative")
+            )
+        if b.deadline_ms < 0:
+            errors.append(
+                ValidationError("budget.deadline_ms", "must not be negative")
+            )
+    return errors
+def validate_job_result(msg: Any) -> List[ValidationError]:
+    """Validate semantic constraints on a JobResult."""
+    errors: List[ValidationError] = []
+    if msg is None:
+        errors.append(ValidationError("JobResult", "must not be nil"))
+        return errors
+    if not msg.job_id:
+        errors.append(ValidationError("job_id", "must not be empty"))
+    if msg.status == job_pb2.JOB_STATUS_UNSPECIFIED:
+        errors.append(ValidationError("status", "must not be UNSPECIFIED"))
+    if not msg.worker_id:
+        errors.append(ValidationError("worker_id", "must not be empty"))
+    if msg.execution_ms < 0:
+        errors.append(
+            ValidationError("execution_ms", "must not be negative")
+        )
+    return errors
+def validate_bus_packet(msg: Any) -> List[ValidationError]:
+    """Validate semantic constraints on a BusPacket.
+    If the packet carries a JobRequest or JobResult payload,
+    it is also validated.
+    """
+    errors: List[ValidationError] = []
+    if msg is None:
+        errors.append(ValidationError("BusPacket", "must not be nil"))
+        return errors
+    if not msg.trace_id:
+        errors.append(ValidationError("trace_id", "must not be empty"))
+    if not msg.sender_id:
+        errors.append(ValidationError("sender_id", "must not be empty"))
+    if msg.protocol_version <= 0:
+        errors.append(ValidationError("protocol_version", "must be > 0"))
+    if not msg.HasField("created_at"):
+        errors.append(ValidationError("created_at", "must not be nil"))
+    payload_field = msg.WhichOneof("payload")
+    if payload_field is None:
+        errors.append(ValidationError("payload", "must not be nil"))
+    elif payload_field == "job_request":
+        errors.extend(validate_job_request(msg.job_request))
+    elif payload_field == "job_result":
+        errors.extend(validate_job_result(msg.job_result))
+    return errors

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap/worker.py RENAMED Viewed

@@ -1,13 +1,17 @@
 import asyncio
+import logging
 from typing import Callable, Awaitable, Dict
 from google.protobuf import timestamp_pb2
+logger = logging.getLogger(__name__)
 from cap.pb.cordum.agent.v1 import buspacket_pb2, job_pb2
 from cryptography.hazmat.primitives.asymmetric import ec
 from cryptography.hazmat.primitives import hashes
+from cap.subjects import SUBJECT_RESULT
 DEFAULT_PROTOCOL_VERSION = 1
-SUBJECT_RESULT = "sys.job.result"
 async def run_worker(nats_url: str, subject: str, handler: Callable[[job_pb2.JobRequest], Awaitable[job_pb2.JobResult]],
@@ -33,7 +37,7 @@ async def run_worker(nats_url: str, subject: str, handler: Callable[[job_pb2.Job
         if public_keys:
             public_key = public_keys.get(packet.sender_id)
             if not public_key:
-                print(f"worker: no public key found for sender: {packet.sender_id}")
+                logger.warning("no public key found for sender: %s", packet.sender_id)
                 return
             signature = packet.signature
@@ -43,7 +47,7 @@ async def run_worker(nats_url: str, subject: str, handler: Callable[[job_pb2.Job
             try:
                 public_key.verify(signature, unsigned_data, ec.ECDSA(hashes.SHA256()))
             except Exception:
-                print(f"worker: invalid signature from sender: {packet.sender_id}")
+                logger.warning("invalid signature from sender: %s", packet.sender_id)
                 return
         req = packet.job_request

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap_sdk_python.egg-info/PKG-INFO RENAMED Viewed

@@ -1,8 +1,13 @@
 Metadata-Version: 2.4
 Name: cap-sdk-python
-Version: 2.0.19
+Version: 2.5.2
 Summary: CAP (Cordum Agent Protocol) Python SDK
+Author-email: Cordum <eng@cordum.io>
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/cordum-io/cap
+Project-URL: Repository, https://github.com/cordum-io/cap
+Project-URL: Issues, https://github.com/cordum-io/cap/issues
+Keywords: cap,cordum,agent,protocol,sdk,ai
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: protobuf>=4.25.0

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap_sdk_python.egg-info/SOURCES.txt RENAMED Viewed

@@ -4,6 +4,8 @@ cap/__init__.py
 cap/bus.py
 cap/client.py
 cap/runtime.py
+cap/subjects.py
+cap/validate.py
 cap/worker.py
 cap/pb/__init__.py
 cap/pb/cordum/__init__.py
@@ -13,6 +15,8 @@ cap/pb/cordum/agent/v1/alert_pb2.py
 cap/pb/cordum/agent/v1/alert_pb2_grpc.py
 cap/pb/cordum/agent/v1/buspacket_pb2.py
 cap/pb/cordum/agent/v1/buspacket_pb2_grpc.py
+cap/pb/cordum/agent/v1/handshake_pb2.py
+cap/pb/cordum/agent/v1/handshake_pb2_grpc.py
 cap/pb/cordum/agent/v1/heartbeat_pb2.py
 cap/pb/cordum/agent/v1/heartbeat_pb2_grpc.py
 cap/pb/cordum/agent/v1/job_pb2.py
@@ -26,4 +30,5 @@ cap_sdk_python.egg-info/requires.txt
 cap_sdk_python.egg-info/top_level.txt
 tests/test_conformance.py
 tests/test_runtime.py
-tests/test_sdk.py
+tests/test_sdk.py
+tests/test_validate.py

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/cap_sdk_python.egg-info/top_level.txt RENAMED Viewed

@@ -1,3 +1,2 @@
 cap
 dist
-tests

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/pyproject.toml RENAMED Viewed

@@ -4,10 +4,13 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "cap-sdk-python"
-version = "2.0.19"
+version = "2.5.2"
 description = "CAP (Cordum Agent Protocol) Python SDK"
 readme = "README.md"
 requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [{name = "Cordum", email = "eng@cordum.io"}]
+keywords = ["cap", "cordum", "agent", "protocol", "sdk", "ai"]
 dependencies = [
   "protobuf>=4.25.0",
   "grpcio>=1.59.0",
@@ -19,6 +22,9 @@ dependencies = [
 [project.urls]
 Homepage = "https://github.com/cordum-io/cap"
+Repository = "https://github.com/cordum-io/cap"
+Issues = "https://github.com/cordum-io/cap/issues"
 [tool.setuptools.packages.find]
 where = ["."]
+exclude = ["tests", "tests.*"]

{cap_sdk_python-2.0.19 → cap_sdk_python-2.5.2}/tests/test_conformance.py RENAMED Viewed

@@ -11,7 +11,7 @@ sys.path = [p for p in sys.path if not p.rstrip("/").endswith("python")]
 sys.path.insert(0, _sdk_root)
 sys.path.append(os.path.join(_sdk_root, "cap", "pb"))
-from cap.pb.cordum.agent.v1 import buspacket_pb2
+from cap.pb.cordum.agent.v1 import alert_pb2, buspacket_pb2, handshake_pb2, job_pb2
 from cryptography.hazmat.primitives import hashes, serialization
 from cryptography.hazmat.primitives.asymmetric import ec
@@ -104,6 +104,35 @@ class TestConformanceFixtures(unittest.TestCase):
         self.assertEqual(alert.level, "WARN")
         self.assertEqual(alert.component, "scheduler")
+    def test_handshake_fixture(self):
+        pkt = load_packet("buspacket_handshake.bin")
+        self._assert_common(pkt, "trace-handshake", "worker-1")
+        hs = pkt.handshake
+        self.assertEqual(hs.component_id, "worker-1")
+        self.assertEqual(hs.role, handshake_pb2.COMPONENT_ROLE_WORKER)
+        self.assertEqual(list(hs.supported_versions), [1])
+        self.assertTrue(hs.capabilities["signatures"])
+        self.assertTrue(hs.capabilities["progress"])
+        self.assertTrue(hs.capabilities["cancel"])
+        self.assertFalse(hs.capabilities["compensation"])
+        self.assertEqual(hs.sdk_version, "2.0.19")
+    def test_alert_enhanced_fixture(self):
+        pkt = load_packet("buspacket_alert_enhanced.bin")
+        self._assert_common(pkt, "trace-alert-enhanced", "scheduler-1")
+        alert = pkt.alert
+        # Legacy fields
+        self.assertEqual(alert.level, "CRITICAL")
+        self.assertEqual(alert.component, "scheduler")
+        self.assertEqual(alert.code, "SIGNATURE_INVALID")
+        # Enhanced fields
+        self.assertEqual(alert.severity, alert_pb2.ALERT_SEVERITY_CRITICAL)
+        self.assertEqual(alert.error_code_enum, job_pb2.ERROR_CODE_PROTOCOL_SIGNATURE_INVALID)
+        self.assertEqual(alert.source_component, "scheduler-1")
+        self.assertEqual(alert.details["sender"], "worker-bad")
+        self.assertEqual(alert.details["subject"], "sys.job.result")
+        self.assertEqual(alert.trace_id, "trace-offending-packet")
 if __name__ == "__main__":
     unittest.main()

cap_sdk_python-2.5.2/tests/test_validate.py ADDED Viewed

@@ -0,0 +1,284 @@
+import os
+import sys
+import unittest
+_repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", ".."))
+_sdk_root = os.path.join(_repo_root, "sdk", "python")
+sys.path = [p for p in sys.path if not p.rstrip("/").endswith("python")]
+sys.path.insert(0, _sdk_root)
+sys.path.append(os.path.join(_sdk_root, "cap", "pb"))
+from google.protobuf import timestamp_pb2
+from cap.pb.cordum.agent.v1 import buspacket_pb2, job_pb2
+from cap.validate import (
+    ValidationError,
+    validate_bus_packet,
+    validate_job_request,
+    validate_job_result,
+)
+def _valid_job_request():
+    return job_pb2.JobRequest(job_id="job-1", topic="job.tools")
+def _valid_job_result():
+    return job_pb2.JobResult(
+        job_id="job-1",
+        status=job_pb2.JOB_STATUS_SUCCEEDED,
+        worker_id="worker-1",
+        execution_ms=100,
+    )
+def _valid_bus_packet(payload=None):
+    req = payload or _valid_job_request()
+    pkt = buspacket_pb2.BusPacket(
+        trace_id="trace-1",
+        sender_id="sender-1",
+        protocol_version=1,
+    )
+    pkt.created_at.CopyFrom(timestamp_pb2.Timestamp(seconds=1000))
+    pkt.job_request.CopyFrom(req)
+    return pkt
+class TestValidateJobRequest(unittest.TestCase):
+    def test_valid_minimal(self):
+        self.assertEqual(validate_job_request(_valid_job_request()), [])
+    def test_valid_with_budget(self):
+        req = _valid_job_request()
+        req.budget.CopyFrom(
+            job_pb2.Budget(
+                max_input_tokens=1000,
+                max_output_tokens=500,
+                max_total_tokens=1500,
+                deadline_ms=30000,
+            )
+        )
+        self.assertEqual(validate_job_request(req), [])
+    def test_valid_with_all_fields(self):
+        req = _valid_job_request()
+        req.priority = job_pb2.JOB_PRIORITY_CRITICAL
+        req.context_ptr = "redis://ctx:1"
+        req.adapter_id = "adapter-1"
+        req.parent_job_id = "parent-1"
+        req.workflow_id = "wf-1"
+        req.step_index = 2
+        req.memory_id = "mem-1"
+        req.tenant_id = "tenant-1"
+        req.principal_id = "user-1"
+        self.assertEqual(validate_job_request(req), [])
+    def test_none(self):
+        errs = validate_job_request(None)
+        self.assertEqual(len(errs), 1)
+        self.assertEqual(errs[0].field, "JobRequest")
+    def test_empty_job_id(self):
+        req = _valid_job_request()
+        req.job_id = ""
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "job_id")
+    def test_empty_topic(self):
+        req = _valid_job_request()
+        req.topic = ""
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "topic")
+    def test_negative_step_index(self):
+        req = _valid_job_request()
+        req.step_index = -1
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "step_index")
+    def test_negative_budget_max_input_tokens(self):
+        req = _valid_job_request()
+        req.budget.CopyFrom(job_pb2.Budget(max_input_tokens=-1))
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "budget.max_input_tokens")
+    def test_negative_budget_max_output_tokens(self):
+        req = _valid_job_request()
+        req.budget.CopyFrom(job_pb2.Budget(max_output_tokens=-1))
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "budget.max_output_tokens")
+    def test_negative_budget_max_total_tokens(self):
+        req = _valid_job_request()
+        req.budget.CopyFrom(job_pb2.Budget(max_total_tokens=-1))
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "budget.max_total_tokens")
+    def test_negative_budget_deadline_ms(self):
+        req = _valid_job_request()
+        req.budget.CopyFrom(job_pb2.Budget(deadline_ms=-1))
+        errs = validate_job_request(req)
+        self._assert_has_field_error(errs, "budget.deadline_ms")
+    def test_zero_value_struct(self):
+        errs = validate_job_request(job_pb2.JobRequest())
+        self._assert_has_field_error(errs, "job_id")
+    def _assert_has_field_error(self, errs, field):
+        fields = [e.field for e in errs]
+        self.assertIn(field, fields, f"Expected error for {field}, got: {errs}")
+class TestValidateJobResult(unittest.TestCase):
+    def test_valid_minimal(self):
+        self.assertEqual(validate_job_result(_valid_job_result()), [])
+    def test_valid_with_all_fields(self):
+        res = _valid_job_result()
+        res.result_ptr = "redis://res:1"
+        res.error_code = "E_TEMP"
+        res.error_message = "temporary failure"
+        res.artifact_ptrs.extend(["redis://art:1", "redis://art:2"])
+        self.assertEqual(validate_job_result(res), [])
+    def test_none(self):
+        errs = validate_job_result(None)
+        self.assertEqual(len(errs), 1)
+        self.assertEqual(errs[0].field, "JobResult")
+    def test_empty_job_id(self):
+        res = _valid_job_result()
+        res.job_id = ""
+        errs = validate_job_result(res)
+        self._assert_has_field_error(errs, "job_id")
+    def test_unspecified_status(self):
+        res = _valid_job_result()
+        res.status = job_pb2.JOB_STATUS_UNSPECIFIED
+        errs = validate_job_result(res)
+        self._assert_has_field_error(errs, "status")
+    def test_empty_worker_id(self):
+        res = _valid_job_result()
+        res.worker_id = ""
+        errs = validate_job_result(res)
+        self._assert_has_field_error(errs, "worker_id")
+    def test_negative_execution_ms(self):
+        res = _valid_job_result()
+        res.execution_ms = -1
+        errs = validate_job_result(res)
+        self._assert_has_field_error(errs, "execution_ms")
+    def test_zero_value_struct(self):
+        errs = validate_job_result(job_pb2.JobResult())
+        self._assert_has_field_error(errs, "job_id")
+    def _assert_has_field_error(self, errs, field):
+        fields = [e.field for e in errs]
+        self.assertIn(field, fields, f"Expected error for {field}, got: {errs}")
+class TestValidateBusPacket(unittest.TestCase):
+    def test_valid_with_job_request(self):
+        self.assertEqual(validate_bus_packet(_valid_bus_packet()), [])
+    def test_valid_with_job_result(self):
+        pkt = buspacket_pb2.BusPacket(
+            trace_id="trace-1",
+            sender_id="sender-1",
+            protocol_version=1,
+        )
+        pkt.created_at.CopyFrom(timestamp_pb2.Timestamp(seconds=1000))
+        pkt.job_result.CopyFrom(_valid_job_result())
+        self.assertEqual(validate_bus_packet(pkt), [])
+    def test_valid_with_heartbeat(self):
+        from cap.pb.cordum.agent.v1 import heartbeat_pb2
+        pkt = buspacket_pb2.BusPacket(
+            trace_id="trace-1",
+            sender_id="sender-1",
+            protocol_version=1,
+        )
+        pkt.created_at.CopyFrom(timestamp_pb2.Timestamp(seconds=1000))
+        pkt.heartbeat.CopyFrom(
+            heartbeat_pb2.Heartbeat(worker_id="w-1", pool="p-1")
+        )
+        self.assertEqual(validate_bus_packet(pkt), [])
+    def test_none(self):
+        errs = validate_bus_packet(None)
+        self.assertEqual(len(errs), 1)
+        self.assertEqual(errs[0].field, "BusPacket")
+    def test_empty_trace_id(self):
+        pkt = _valid_bus_packet()
+        pkt.trace_id = ""
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "trace_id")
+    def test_empty_sender_id(self):
+        pkt = _valid_bus_packet()
+        pkt.sender_id = ""
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "sender_id")
+    def test_protocol_version_zero(self):
+        pkt = _valid_bus_packet()
+        pkt.protocol_version = 0
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "protocol_version")
+    def test_nil_created_at(self):
+        pkt = buspacket_pb2.BusPacket(
+            trace_id="trace-1",
+            sender_id="sender-1",
+            protocol_version=1,
+        )
+        pkt.job_request.CopyFrom(_valid_job_request())
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "created_at")
+    def test_nil_payload(self):
+        pkt = buspacket_pb2.BusPacket(
+            trace_id="trace-1",
+            sender_id="sender-1",
+            protocol_version=1,
+        )
+        pkt.created_at.CopyFrom(timestamp_pb2.Timestamp(seconds=1000))
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "payload")
+    def test_delegates_to_job_request_validation(self):
+        bad = job_pb2.JobRequest(job_id="", topic="t")
+        pkt = _valid_bus_packet(bad)
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "job_id")
+    def test_delegates_to_job_result_validation(self):
+        bad = job_pb2.JobResult(
+            job_id="", status=job_pb2.JOB_STATUS_SUCCEEDED, worker_id="w"
+        )
+        pkt = buspacket_pb2.BusPacket(
+            trace_id="trace-1",
+            sender_id="sender-1",
+            protocol_version=1,
+        )
+        pkt.created_at.CopyFrom(timestamp_pb2.Timestamp(seconds=1000))
+        pkt.job_result.CopyFrom(bad)
+        errs = validate_bus_packet(pkt)
+        self._assert_has_field_error(errs, "job_id")
+    def test_zero_value_struct(self):
+        errs = validate_bus_packet(buspacket_pb2.BusPacket())
+        self._assert_has_field_error(errs, "trace_id")
+    def _assert_has_field_error(self, errs, field):
+        fields = [e.field for e in errs]
+        self.assertIn(field, fields, f"Expected error for {field}, got: {errs}")
+if __name__ == "__main__":
+    unittest.main()

cap_sdk_python-2.0.19/cap/pb/cordum/agent/v1/alert_pb2.py DELETED Viewed

@@ -1,37 +0,0 @@
-# -*- coding: utf-8 -*-
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# NO CHECKED-IN PROTOBUF GENCODE
-# source: cordum/agent/v1/alert.proto
-# Protobuf Python Version: 6.31.1
-"""Generated protocol buffer code."""
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import descriptor_pool as _descriptor_pool
-from google.protobuf import runtime_version as _runtime_version
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf.internal import builder as _builder
-_runtime_version.ValidateProtobufRuntimeVersion(
-    _runtime_version.Domain.PUBLIC,
-    6,
-    31,
-    1,
-    '',
-    'cordum/agent/v1/alert.proto'
-)
-# @@protoc_insertion_point(imports)
-_sym_db = _symbol_database.Default()
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1b\x63ordum/agent/v1/alert.proto\x12\x0f\x63ordum.agent.v1\"N\n\x0bSystemAlert\x12\r\n\x05level\x18\x01 \x01(\t\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x11\n\tcomponent\x18\x03 \x01(\t\x12\x0c\n\x04\x63ode\x18\x04 \x01(\tB\x7f\n\x16io.cordum.cap.agent.v1P\x01Z+github.com/cordum-io/cap/v2/cordum/agent/v1\xaa\x02\x0f\x43ordum.Agent.V1\xca\x02\x0f\x63ordum\\Agent\\V1\xea\x02\x11\x43ordum::Agent::V1b\x06proto3')
-_globals = globals()
-_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'cordum.agent.v1.alert_pb2', _globals)
-if not _descriptor._USE_C_DESCRIPTORS:
-  _globals['DESCRIPTOR']._loaded_options = None
-  _globals['DESCRIPTOR']._serialized_options = b'\n\026io.cordum.cap.agent.v1P\001Z+github.com/cordum-io/cap/v2/cordum/agent/v1\252\002\017Cordum.Agent.V1\312\002\017cordum\\Agent\\V1\352\002\021Cordum::Agent::V1'
-  _globals['_SYSTEMALERT']._serialized_start=48
-  _globals['_SYSTEMALERT']._serialized_end=126
-# @@protoc_insertion_point(module_scope)