anip-runtime-utils 0.24.10__tar.gz

anip_runtime_utils-0.24.10/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: anip-runtime-utils
+Version: 0.24.10
+Summary: Small shared runtime utilities for ANIP-based agent runtimes
+Author-email: ANIP Protocol <team@anip.dev>
+License: Apache-2.0
+Keywords: anip,runtime,agent
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"

anip_runtime_utils-0.24.10/README.md

@@ -0,0 +1,30 @@
+# anip-runtime-utils
+
+Small shared runtime helpers for agent-side deterministic normalization and
+preflight handling.
+
+These helpers assist consuming agents with routing, compact prompt construction,
+and contract-derived preflight checks. They are not the trust boundary. The
+authoritative policy decision remains the ANIP service invocation result.
+
+Current scope:
+
+- metadata-driven enum/default normalization
+- compact agent capability catalog construction from discovery + manifest payloads
+- generic phrase matching
+- generic denied-preflight payload construction
+
+Non-goals:
+
+- domain vocabulary parsing
+- service-local aliases
+- business-policy decisions that belong in ANIP services
+
+This package is intentionally small. It exists to promote clearly reusable
+runtime patterns without pulling GTM-specific logic into a shared layer.
+
+`build_agent_capability_catalog(...)` keeps rich ANIP manifests available to the
+runtime while producing a compact routing brief for model prompts. Agent
+runtimes should not blindly send full manifests or package metadata to the LLM
+on every turn; they should send a purpose-built brief and keep the full metadata
+for deterministic normalization, token issuance, invocation, and audit.

anip_runtime_utils-0.24.10/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "anip-runtime-utils"
+version = "0.24.10"
+description = "Small shared runtime utilities for ANIP-based agent runtimes"
+requires-python = ">=3.11"
+dependencies = []
+authors = [{ name = "ANIP Protocol", email = "team@anip.dev" }]
+license = { text = "Apache-2.0" }
+keywords = ["anip", "runtime", "agent"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0"]
+
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

anip_runtime_utils-0.24.10/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

anip_runtime_utils-0.24.10/src/anip_runtime_utils/__init__.py

@@ -0,0 +1,140 @@
+"""Shared runtime utilities for ANIP-based agent runtimes."""
+
+from .agent_consumption import (
+    build_agent_capability_catalog,
+    build_clarification_continuation,
+    build_clarification_continuation_prompt,
+    build_compact_agent_capability_brief,
+    canonical_from_candidates,
+    candidate_map_for_input,
+    clarification_continuation_from_history,
+    app_boundaries_for,
+    capability_does_not_produce,
+    capability_match_score,
+    capability_produces,
+    compact_capability_match_score,
+    conditional_approval_boundary,
+    conditional_approval_missing_inputs,
+    conditional_approval_produces,
+    content_tokens,
+    conversation_contains_value,
+    conversation_supports_canonical_value,
+    conversation_text_from_history,
+    compact_agent_json,
+    effective_business_effects,
+    has_approval_intent,
+    input_meanings_for,
+    input_semantics_for,
+    infer_declared_input_value,
+    has_conditional_approval_boundary,
+    is_approval_capability,
+    is_conditional_approval_boundary_active,
+    is_deictic_reference,
+    is_ungrounded_declared_context,
+    looks_like_quarter_input,
+    metadata_with_manifest_controls,
+    normalize_clarification_continuation_plan,
+    normalize_declared_input_value,
+    normalize_declared_parameters,
+    normalize_invocation_plan,
+    normalize_reference_value,
+    quarter_label_from_text,
+    reference_catalog_for,
+    render_agent_business_effects,
+    render_agent_detail_metadata,
+    render_agent_input_spec,
+    render_agent_routing_metadata,
+    render_compact_agent_capability_line,
+    render_compact_agent_input_summary,
+    requested_primary_content_effect,
+    requested_unsupported_effects,
+    required_context_for,
+    requires_declared_grounding,
+    semantic_text_key,
+    select_approval_boundary_capability,
+    select_consumable_capability,
+    select_declared_effect_capability,
+    select_profile_hint_capability,
+    selected_agent_capability_detail,
+    should_clear_planner_unsupported_for_approval_boundary,
+    should_clear_planner_unsupported_for_declared_effect,
+    text_tokens,
+    token_score,
+    user_authored_conversation_text,
+)
+from .normalization import (
+    apply_input_metadata_defaults_and_enums,
+    infer_allowed_value_from_history,
+    normalize_by_allowed_values,
+    semantic_key,
+)
+from .preflight import build_denied_preflight_result, contains_any_phrase
+
+__all__ = [
+    "apply_input_metadata_defaults_and_enums",
+    "app_boundaries_for",
+    "build_agent_capability_catalog",
+    "build_clarification_continuation",
+    "build_clarification_continuation_prompt",
+    "build_compact_agent_capability_brief",
+    "build_denied_preflight_result",
+    "canonical_from_candidates",
+    "candidate_map_for_input",
+    "capability_does_not_produce",
+    "capability_match_score",
+    "capability_produces",
+    "compact_capability_match_score",
+    "clarification_continuation_from_history",
+    "conditional_approval_boundary",
+    "conditional_approval_missing_inputs",
+    "conditional_approval_produces",
+    "contains_any_phrase",
+    "content_tokens",
+    "conversation_contains_value",
+    "conversation_supports_canonical_value",
+    "conversation_text_from_history",
+    "compact_agent_json",
+    "effective_business_effects",
+    "has_approval_intent",
+    "has_conditional_approval_boundary",
+    "infer_allowed_value_from_history",
+    "infer_declared_input_value",
+    "input_meanings_for",
+    "input_semantics_for",
+    "is_approval_capability",
+    "is_conditional_approval_boundary_active",
+    "is_deictic_reference",
+    "is_ungrounded_declared_context",
+    "looks_like_quarter_input",
+    "metadata_with_manifest_controls",
+    "normalize_clarification_continuation_plan",
+    "normalize_declared_input_value",
+    "normalize_declared_parameters",
+    "normalize_invocation_plan",
+    "normalize_reference_value",
+    "normalize_by_allowed_values",
+    "quarter_label_from_text",
+    "reference_catalog_for",
+    "render_agent_business_effects",
+    "render_agent_detail_metadata",
+    "render_agent_input_spec",
+    "render_agent_routing_metadata",
+    "render_compact_agent_capability_line",
+    "render_compact_agent_input_summary",
+    "requested_primary_content_effect",
+    "requested_unsupported_effects",
+    "required_context_for",
+    "requires_declared_grounding",
+    "semantic_key",
+    "semantic_text_key",
+    "select_approval_boundary_capability",
+    "select_consumable_capability",
+    "select_declared_effect_capability",
+    "select_profile_hint_capability",
+    "selected_agent_capability_detail",
+    "should_clear_planner_unsupported_for_approval_boundary",
+    "should_clear_planner_unsupported_for_declared_effect",
+    "text_tokens",
+    "token_score",
+    "user_authored_conversation_text",
+]