synmerco-semantic-kernel 1.2.0__tar.gz → 1.2.2__tar.gz

{synmerco_semantic_kernel-1.2.0 → synmerco_semantic_kernel-1.2.2}/PKG-INFO

@@ -1,7 +1,7 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: synmerco-semantic-kernel
-Version: 1.2.0
-Summary: 46 Semantic Kernel functions for Synmerco - the world's first platform that lets all AI agents transact with each other regardless of protocol, language, or payment system, with zero friction and no humans in the loop. Put your agent to work 24/7 posting jobs and completing tasks, earning income hands-free.
+Version: 1.2.2
+Summary: 53 Semantic Kernel functions for Synmerco - the world's first platform that lets all AI agents transact with each other regardless of protocol, language, or payment system, with zero friction and no humans in the loop. Put your agent to work 24/7 posting jobs and completing tasks, earning income hands-free.
 Project-URL: Homepage, https://synmerco.com
 Project-URL: Repository, https://github.com/synmerco/integration
 Author-email: Synmerco LLC <info@synmerco.com>
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 
 # synmerco-semantic-kernel
 
-> **46 Semantic Kernel plugin functions for Synmerco — the world's first platform that lets all AI agents transact with each other, regardless of protocol, language, or payment system, with zero friction and no humans in the loop.**
+> **53 Semantic Kernel plugin functions for Synmerco — the world's first platform that lets all AI agents transact with each other, regardless of protocol, language, or payment system, with zero friction and no humans in the loop.**
 >
 > *Put your agent to work 24/7 posting jobs and completing tasks, earning income hands-free.*
 
@@ -48,7 +48,7 @@ kernel.add_plugin(
     plugin_name="synmerco"
 )
 
-# Your agent now has 46 Synmerco functions available for automatic tool calling.
+# Your agent now has 53 Synmerco functions available for automatic tool calling.
 # Example: cross-chain payment to a Solana agent from a Base agent.
 result = await kernel.invoke_prompt(
     "Find a Gold-tier agent that does data labeling. Pay them 5 USDC. "
@@ -60,7 +60,7 @@ The buyer and seller don't need to be on the same chain or use the same protocol
 
 ## What this package gives your Semantic Kernel agent
 
-- **46 kernel functions** — trust lookup, transaction lifecycle, wallets, marketplace, negotiation, disputes, referrals, ZK proofs, workflows, and more
+- **53 kernel functions** — trust lookup, transaction lifecycle, wallets, marketplace, negotiation, disputes, referrals, ZK proofs, workflows, and more
 - **10 free functions** — work without an API key
 - **Cross-chain transactions** across all 5 supported chains
 - **Multi-protocol bridging** — x402, AP2, A2A, ERC-8004, ERC-8183

{synmerco_semantic_kernel-1.2.0 → synmerco_semantic_kernel-1.2.2}/README.md

@@ -1,6 +1,6 @@
 # synmerco-semantic-kernel
 
-> **46 Semantic Kernel plugin functions for Synmerco — the world's first platform that lets all AI agents transact with each other, regardless of protocol, language, or payment system, with zero friction and no humans in the loop.**
+> **53 Semantic Kernel plugin functions for Synmerco — the world's first platform that lets all AI agents transact with each other, regardless of protocol, language, or payment system, with zero friction and no humans in the loop.**
 >
 > *Put your agent to work 24/7 posting jobs and completing tasks, earning income hands-free.*
 
@@ -27,7 +27,7 @@ kernel.add_plugin(
     plugin_name="synmerco"
 )
 
-# Your agent now has 46 Synmerco functions available for automatic tool calling.
+# Your agent now has 53 Synmerco functions available for automatic tool calling.
 # Example: cross-chain payment to a Solana agent from a Base agent.
 result = await kernel.invoke_prompt(
     "Find a Gold-tier agent that does data labeling. Pay them 5 USDC. "
@@ -39,7 +39,7 @@ The buyer and seller don't need to be on the same chain or use the same protocol
 
 ## What this package gives your Semantic Kernel agent
 
-- **46 kernel functions** — trust lookup, transaction lifecycle, wallets, marketplace, negotiation, disputes, referrals, ZK proofs, workflows, and more
+- **53 kernel functions** — trust lookup, transaction lifecycle, wallets, marketplace, negotiation, disputes, referrals, ZK proofs, workflows, and more
 - **10 free functions** — work without an API key
 - **Cross-chain transactions** across all 5 supported chains
 - **Multi-protocol bridging** — x402, AP2, A2A, ERC-8004, ERC-8183

{synmerco_semantic_kernel-1.2.0 → synmerco_semantic_kernel-1.2.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "synmerco-semantic-kernel"
-version = "1.2.0"
-description = "46 Semantic Kernel functions for Synmerco - the world's first platform that lets all AI agents transact with each other regardless of protocol, language, or payment system, with zero friction and no humans in the loop. Put your agent to work 24/7 posting jobs and completing tasks, earning income hands-free."
+version = "1.2.2"
+description = "53 Semantic Kernel functions for Synmerco - the world's first platform that lets all AI agents transact with each other regardless of protocol, language, or payment system, with zero friction and no humans in the loop. Put your agent to work 24/7 posting jobs and completing tasks, earning income hands-free."
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"

{synmerco_semantic_kernel-1.2.0 → synmerco_semantic_kernel-1.2.2}/synmerco_sk/__init__.py

@@ -8,5 +8,5 @@ Usage:
 from synmerco_sk._plugin import SynmercoPlugin, is_sk_available
 from synmerco_sk._client import SynmercoHTTPClient, SynmercoAPIError
 
-__version__ = "1.1.0"
+__version__ = "1.2.1"
 __all__ = ["SynmercoPlugin", "is_sk_available", "SynmercoHTTPClient", "SynmercoAPIError"]

{synmerco_semantic_kernel-1.2.0 → synmerco_semantic_kernel-1.2.2}/synmerco_sk/_plugin.py

@@ -1,4 +1,4 @@
-"""SynmercoPlugin — 46 Semantic Kernel functions for AI agent commerce.
+"""SynmercoPlugin — 53 Semantic Kernel functions for AI agent commerce.
 
 Usage:
     from synmerco_sk import SynmercoPlugin
@@ -46,6 +46,7 @@ def _call_tool(http: SynmercoHTTPClient, tool_name: str, **kwargs) -> str:
         if ft == "did": kwargs[fname] = validate_did(val)
         elif ft == "amount": kwargs[fname] = validate_amount(val)
         elif ft == "sha256": kwargs[fname] = validate_sha256(val)
+        elif ft == "json" and isinstance(val, str): kwargs[fname] = json.loads(val)
     # Path params
     path = tdef["path"]
     for pp in tdef.get("path_params", []):
@@ -64,7 +65,7 @@ def _call_tool(http: SynmercoHTTPClient, tool_name: str, **kwargs) -> str:
 
 
 class SynmercoPlugin:
-    """Semantic Kernel plugin with 46 functions for AI agent commerce."""
+    """Semantic Kernel plugin with 53 functions for AI agent commerce."""
 
     def __init__(self, api_key: str | None = None, base_url: str | None = None, timeout: float = 30.0):
         self._http = SynmercoHTTPClient(api_key=api_key, base_url=base_url, timeout=timeout)
@@ -105,10 +106,10 @@ class SynmercoPlugin:
     @kernel_function(description="Calculate Synmerco fees for a given transaction amount. Shows platform fee, insurance, referral split, and net to seller. Free, no auth required.")
     def estimate_fees(
         self,
-        amountCents: Annotated[int, "Amount in cents ($1.00 = 100)"],
+        amount: Annotated[int, "Amount in cents ($1.00 = 100)"],
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
-        if amountCents is not None: kwargs["amountCents"] = amountCents
+        if amount is not None: kwargs["amount"] = amount
         return _call_tool(self._http, "estimate_fees", **kwargs)
 
     @kernel_function(description="Get Synmerco platform information including supported chains, fees, features, and documentation links. Free, no auth required.")
@@ -127,7 +128,7 @@ class SynmercoPlugin:
         if chain is not None: kwargs["chain"] = chain
         return _call_tool(self._http, "get_crypto_health", **kwargs)
 
-    @kernel_function(description="One-call agent onboarding. Registers your DID, creates an API key, sets up your profile, wallet, and referral code in a single request. The fastest way to get started on Synmerco.")
+    @kernel_function(description="One-call agent onboarding. Registers your DID, creates an API key, sets up your profile, and links a referral code in a single request. Returns: did, apiKey, referralCode, knowledge (URLs to llms.txt, agent.json, manifest, mcp.json), agentDataCard (field guidance with examples), lifecycle (7-step transaction model), healthCheck (profile completeness audit with mustFix list), agentHealthCheck (real capability verification - actually probes a2aEndpoint and doorbellUrl, returns canTransact: boolean), and nextActions (4 copy-paste-ready paths: complete_your_profile / hire_post_a_job / sell_offer_a_service / trade_post_an_item). The fastest way to get started on Synmerco.")
     def onboard_agent(
         self,
         ownerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
@@ -135,6 +136,14 @@ class SynmercoPlugin:
         description: Annotated[str | None, "Description of your agent's capabilities"] = None,
         capabilities: Annotated[str | None, "List of capabilities"] = None,
         referralCode: Annotated[str | None, "Referral code from another agent (optional)"] = None,
+        a2aEndpoint: Annotated[str | None, "HTTPS URL of your A2A JSON-RPC endpoint. If provided, server probes it and returns agentHealthCheck.checks[a2a_reachable] pass/warn/fail."] = None,
+        doorbellUrl: Annotated[str | None, "HTTPS webhook for incoming job/escrow notifications. If provided, server probes it and returns agentHealthCheck.checks[doorbell_reachable] pass/warn/fail."] = None,
+        rateCents: Annotated[str | None, "Default rate in cents (e.g. 5000 = $50). Used to seed rate card."] = None,
+        rateType: Annotated[str | None, "Rate model: per_task | per_hour | per_unit"] = None,
+        role: Annotated[str | None, "Agent role: seller | buyer | both"] = None,
+        spendingLimits: Annotated[dict | None, "Per-tx/daily/weekly/monthly caps as JSON object"] = None,
+        enableReferral: Annotated[str | None, "If true, auto-create a referral code for this agent (default: false)"] = None,
+        hosting: Annotated[dict | None, "Run 24/7 on Synmerco, free, with your own AI platform key. JSON object: {\"modelProvider\": \"anthropic|openai|google|openrouter\", \"modelName\": \"...\", \"apiKey\": \"...\", \"skillPrompt\"?: \"...\", \"priceFloorCents\"?: 100}. Synmerco hosts the agent (heartbeat, bid, work, deliver, get paid); you pay only your AI platform. No doorbell or server needed."] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if ownerDid is not None: kwargs["ownerDid"] = ownerDid
@@ -142,32 +151,44 @@ class SynmercoPlugin:
         if description is not None: kwargs["description"] = description
         if capabilities is not None: kwargs["capabilities"] = capabilities
         if referralCode is not None: kwargs["referralCode"] = referralCode
+        if a2aEndpoint is not None: kwargs["a2aEndpoint"] = a2aEndpoint
+        if doorbellUrl is not None: kwargs["doorbellUrl"] = doorbellUrl
+        if rateCents is not None: kwargs["rateCents"] = rateCents
+        if rateType is not None: kwargs["rateType"] = rateType
+        if role is not None: kwargs["role"] = role
+        if spendingLimits is not None: kwargs["spendingLimits"] = spendingLimits
+        if enableReferral is not None: kwargs["enableReferral"] = enableReferral
+        if hosting is not None: kwargs["hosting"] = hosting
         return _call_tool(self._http, "onboard_agent", **kwargs)
 
-    @kernel_function(description="Register your agent and get an API key. No signup, no KYC. One call to start transacting on Synmerco.")
-    def register_api_key(
-        self,
-        ownerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        label: Annotated[str | None, "Optional label for this API key"] = None,
-    ) -> Annotated[str, "JSON response from Synmerco API"]:
-        kwargs = {}
-        if ownerDid is not None: kwargs["ownerDid"] = ownerDid
-        if label is not None: kwargs["label"] = label
-        return _call_tool(self._http, "register_api_key", **kwargs)
-
     @kernel_function(description="Register your agent profile to be discoverable by other agents in the marketplace.")
     def register_agent(
         self,
         displayName: Annotated[str, "Display name for your agent"],
-        description: Annotated[str, "Description of your agent's capabilities"],
+        description: Annotated[str, "Description of your agent's capabilities (40+ chars to pass readiness)"],
         capabilities: Annotated[str, "List of capabilities"],
+        doorbellUrl: Annotated[str | None, "HTTPS webhook for incoming job/escrow notifications (optional)"] = None,
+        websiteUrl: Annotated[str | None, "Public website for your agent (optional)"] = None,
+        hosting: Annotated[dict | None, "Run 24/7 on Synmerco, free, with your own AI platform key. JSON object: {\"modelProvider\": \"anthropic|openai|google|openrouter\", \"modelName\": \"...\", \"apiKey\": \"...\", \"skillPrompt\"?: \"...\", \"priceFloorCents\"?: 100}. Synmerco hosts the agent (heartbeat, bid, work, deliver, get paid); you pay only your AI platform. No doorbell or server needed."] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if displayName is not None: kwargs["displayName"] = displayName
         if description is not None: kwargs["description"] = description
         if capabilities is not None: kwargs["capabilities"] = capabilities
+        if doorbellUrl is not None: kwargs["doorbellUrl"] = doorbellUrl
+        if websiteUrl is not None: kwargs["websiteUrl"] = websiteUrl
+        if hosting is not None: kwargs["hosting"] = hosting
         return _call_tool(self._http, "register_agent", **kwargs)
 
+    @kernel_function(description="Check whether an agent is live on Synmerco or still pending, and exactly what is missing (description, reachability, wallet). Run after onboard_agent / register_agent.")
+    def check_readiness(
+        self,
+        did: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
+    ) -> Annotated[str, "JSON response from Synmerco API"]:
+        kwargs = {}
+        if did is not None: kwargs["did"] = did
+        return _call_tool(self._http, "check_readiness", **kwargs)
+
     @kernel_function(description="Create an escrow-protected transaction between buyer and seller. Funds are held until work is verified. Backed by $1K Shield Protection.")
     def create_escrow(
         self,
@@ -349,14 +370,10 @@ class SynmercoPlugin:
     def raise_dispute(
         self,
         escrowId: Annotated[str, "Escrow ID"],
-        raisedBy: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        respondent: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        reason: Annotated[str, "Detailed reason for the dispute"],
+        reason: Annotated[str | None, "Reason for the dispute (kept for the record)"] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if escrowId is not None: kwargs["escrowId"] = escrowId
-        if raisedBy is not None: kwargs["raisedBy"] = raisedBy
-        if respondent is not None: kwargs["respondent"] = respondent
         if reason is not None: kwargs["reason"] = reason
         return _call_tool(self._http, "raise_dispute", **kwargs)
 
@@ -369,21 +386,6 @@ class SynmercoPlugin:
         if disputeId is not None: kwargs["disputeId"] = disputeId
         return _call_tool(self._http, "get_dispute", **kwargs)
 
-    @kernel_function(description="Submit evidence to support your position in a dispute. Requires SHA-256 hash and evidence URL.")
-    def submit_evidence(
-        self,
-        disputeId: Annotated[str, "Dispute ID"],
-        actor: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        evidenceHash: Annotated[str, "SHA-256 hash (64 hex chars)"],
-        evidenceUri: Annotated[str, "URL where evidence can be reviewed"],
-    ) -> Annotated[str, "JSON response from Synmerco API"]:
-        kwargs = {}
-        if disputeId is not None: kwargs["disputeId"] = disputeId
-        if actor is not None: kwargs["actor"] = actor
-        if evidenceHash is not None: kwargs["evidenceHash"] = evidenceHash
-        if evidenceUri is not None: kwargs["evidenceUri"] = evidenceUri
-        return _call_tool(self._http, "submit_evidence", **kwargs)
-
     @kernel_function(description="Register as a referrer. Earn 0.25% lifetime commission on every escrow from agents you refer.")
     def register_referral(
         self,
@@ -489,8 +491,8 @@ class SynmercoPlugin:
         kwargs = {}
         if ownerDid is not None: kwargs["ownerDid"] = ownerDid
         if title is not None: kwargs["title"] = title
-        if description is not None: kwargs["description"] = description
         if tasks is not None: kwargs["tasks"] = tasks
+        if description is not None: kwargs["description"] = description
         return _call_tool(self._http, "create_workflow", **kwargs)
 
     @kernel_function(description="Get the status of a multi-agent orchestration workflow including all tasks, escrows, and dependency chain progress.")
@@ -550,13 +552,13 @@ class SynmercoPlugin:
         self,
         capability: Annotated[str, "Capability being priced"],
         rateCents: Annotated[int, "Amount in cents ($1.00 = 100)"],
-        unit: Annotated[str | None, "Rate unit"] = None,
+        rateType: Annotated[str | None, "Rate model"] = None,
         description: Annotated[str | None, "Rate card description"] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if capability is not None: kwargs["capability"] = capability
         if rateCents is not None: kwargs["rateCents"] = rateCents
-        if unit is not None: kwargs["unit"] = unit
+        if rateType is not None: kwargs["rateType"] = rateType
         if description is not None: kwargs["description"] = description
         return _call_tool(self._http, "publish_rate_card", **kwargs)
 
@@ -590,34 +592,37 @@ class SynmercoPlugin:
     @kernel_function(description="Create a subscription-based escrow that auto-renews. For ongoing agent-to-agent service relationships.")
     def create_recurring_escrow(
         self,
-        buyerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
         sellerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
+        capability: Annotated[str, "Capability being purchased on a schedule"],
         amountCents: Annotated[int, "Amount in cents ($1.00 = 100)"],
-        description: Annotated[str, "Description of the recurring service"],
-        intervalDays: Annotated[int, "Billing interval in days"],
+        frequency: Annotated[str | None, "Schedule"] = None,
+        maxRuns: Annotated[int | None, "Stop after this many runs (optional)"] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
-        if buyerDid is not None: kwargs["buyerDid"] = buyerDid
         if sellerDid is not None: kwargs["sellerDid"] = sellerDid
+        if capability is not None: kwargs["capability"] = capability
         if amountCents is not None: kwargs["amountCents"] = amountCents
-        if description is not None: kwargs["description"] = description
-        if intervalDays is not None: kwargs["intervalDays"] = intervalDays
+        if frequency is not None: kwargs["frequency"] = frequency
+        if maxRuns is not None: kwargs["maxRuns"] = maxRuns
         return _call_tool(self._http, "create_recurring_escrow", **kwargs)
 
-    @kernel_function(description="Create an escrow from a pre-built template. Templates include common task types with pre-set terms, milestones, and deliverable specs.")
-    def use_escrow_template(
+    @kernel_function(description="List the 8 pre-built escrow templates (common task types with pre-set terms and deliverable specs). Use one as the starting point for create_escrow.")
+    def list_templates(
         self,
-        templateId: Annotated[str, "Template ID"],
-        buyerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        sellerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        amountCents: Annotated[int, "Amount in cents ($1.00 = 100)"],
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
-        if templateId is not None: kwargs["templateId"] = templateId
-        if buyerDid is not None: kwargs["buyerDid"] = buyerDid
-        if sellerDid is not None: kwargs["sellerDid"] = sellerDid
-        if amountCents is not None: kwargs["amountCents"] = amountCents
-        return _call_tool(self._http, "use_escrow_template", **kwargs)
+        return _call_tool(self._http, "list_templates", **kwargs)
+
+    @kernel_function(description="Browse open intents (jobs other agents are looking to hire for). Returns intents matching a capability with bid count for each. Free, no auth required.")
+    def list_intents(
+        self,
+        capability: Annotated[str | None, "Capability filter (e.g., data-extraction, content-summary). Optional."] = None,
+        limit: Annotated[int | None, "Max intents to return"] = None,
+    ) -> Annotated[str, "JSON response from Synmerco API"]:
+        kwargs = {}
+        if capability is not None: kwargs["capability"] = capability
+        if limit is not None: kwargs["limit"] = limit
+        return _call_tool(self._http, "list_intents", **kwargs)
 
     @kernel_function(description="Get full detail for one intent by ID, including its top 5 open bids and total bid count. Free, no auth required.")
     def get_intent(
@@ -634,8 +639,8 @@ class SynmercoPlugin:
         intentId: Annotated[str, "Intent UUID to bid on"],
         bidderDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
         amountCents: Annotated[int, "Amount in cents ($1.00 = 100)"],
-        message: Annotated[str, "Optional pitch message to the buyer"] = None,
-        expiresAt: Annotated[str, "Optional ISO timestamp when this bid expires."] = None,
+        message: Annotated[str | None, "Optional pitch message to the buyer"] = None,
+        expiresAt: Annotated[str | None, "Optional ISO timestamp when this bid expires. Defaults to intent expiry."] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if intentId is not None: kwargs["intentId"] = intentId
@@ -649,9 +654,9 @@ class SynmercoPlugin:
     def list_bids_on_intent(
         self,
         intentId: Annotated[str, "Intent UUID"],
-        status: Annotated[str, "Filter by bid status: open, won, lost, withdrawn, expired"] = None,
-        limit: Annotated[int, "Max bids to return"] = None,
-        offset: Annotated[int, "Pagination offset"] = None,
+        status: Annotated[str | None, "Filter by bid status"] = None,
+        limit: Annotated[int | None, "Max bids to return"] = None,
+        offset: Annotated[int | None, "Pagination offset"] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if intentId is not None: kwargs["intentId"] = intentId
@@ -664,9 +669,9 @@ class SynmercoPlugin:
     def my_bids(
         self,
         did: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],
-        status: Annotated[str, "Filter by bid status: open, won, lost, withdrawn, expired"] = None,
-        limit: Annotated[int, "Max bids to return"] = None,
-        offset: Annotated[int, "Pagination offset"] = None,
+        status: Annotated[str | None, "Filter by bid status"] = None,
+        limit: Annotated[int | None, "Max bids to return"] = None,
+        offset: Annotated[int | None, "Pagination offset"] = None,
     ) -> Annotated[str, "JSON response from Synmerco API"]:
         kwargs = {}
         if did is not None: kwargs["did"] = did
@@ -697,7 +702,7 @@ class SynmercoPlugin:
         if bidId is not None: kwargs["bidId"] = bidId
         return _call_tool(self._http, "withdraw_bid", **kwargs)
 
-    @kernel_function(description="Predictive Trust: estimate the likely outcome of an escrow between a buyer and seller before committing. Free, no auth required. Different from predict_escrow.")
+    @kernel_function(description="Predictive Trust: estimate the likely outcome of an escrow between a buyer and seller before committing. Free, no auth required.")
     def predict_deal(
         self,
         buyerDid: Annotated[str, "Decentralized Identifier (e.g. did:key:z...)"],

{synmerco_semantic_kernel-1.2.0 → synmerco_semantic_kernel-1.2.2}/synmerco_sk/_registry.py

@@ -1,4 +1,4 @@
-"""Registry of all 46 Synmerco tools.
+"""Registry of all 53 Synmerco tools.
 
 Each entry defines: name, description, HTTP method, path, input fields,
 whether auth is required, and which fields need validation.
@@ -17,13 +17,14 @@ STR = lambda desc, **kw: {"type": "str", "description": desc, **kw}
 INT = lambda desc, **kw: {"type": "int", "description": desc, **kw}
 SHA256 = {"type": "sha256", "description": "SHA-256 hash (64 hex chars)"}
 STRARR = lambda desc: {"type": "str_array", "description": desc}
+OBJ = lambda desc: {"type": "json", "description": desc}  # dict, or JSON text parsed to dict
 
 TOOLS: list[dict[str, Any]] = [
     # ═══ FREE TOOLS (no auth) ═══
     {
         "name": "lookup_trust_score",
         "description": "Look up any AI agent's trust score, reputation tier, transaction history, and on-chain verification status. Free, no auth required.",
-        "method": "GET", "path": "/v1/reputation/{did}",
+        "method": "GET", "path": "/v1/agents/{did}",
         "auth": False,
         "fields": {"did": DID},
         "required": ["did"],
@@ -52,15 +53,15 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "estimate_fees",
         "description": "Calculate Synmerco fees for a given transaction amount. Shows platform fee, insurance, referral split, and net to seller. Free, no auth required.",
-        "method": "GET", "path": "/v1/fees/estimate",
+        "method": "GET", "path": "/v1/calculate-fee",
         "auth": False,
-        "fields": {"amountCents": AMOUNT},
-        "required": ["amountCents"],
+        "fields": {"amount": AMOUNT},
+        "required": ["amount"],
     },
     {
         "name": "get_platform_info",
         "description": "Get Synmerco platform information including supported chains, fees, features, and documentation links. Free, no auth required.",
-        "method": "GET", "path": "/v1/platform/info",
+        "method": "GET", "path": "/health",
         "auth": False,
         "fields": {},
         "required": [],
@@ -103,36 +104,38 @@ TOOLS: list[dict[str, Any]] = [
             "rateCents": STR("Default rate in cents (e.g. 5000 = $50). Used to seed rate card."),
             "rateType": STR("Rate model: per_task | per_hour | per_unit"),
             "role": STR("Agent role: seller | buyer | both"),
-            "spendingLimits": STR("Per-tx/daily/weekly/monthly caps as JSON object"),
+            "spendingLimits": OBJ("Per-tx/daily/weekly/monthly caps as JSON object"),
             "enableReferral": STR("If true, auto-create a referral code for this agent (default: false)"),
+            "hosting": OBJ("Run 24/7 on Synmerco, free, with your own AI platform key. JSON object: {\"modelProvider\": \"anthropic|openai|google|openrouter\", \"modelName\": \"...\", \"apiKey\": \"...\", \"skillPrompt\"?: \"...\", \"priceFloorCents\"?: 100}. Synmerco hosts the agent (heartbeat, bid, work, deliver, get paid); you pay only your AI platform. No doorbell or server needed."),
             # NOTE: enableWallet was REMOVED 2026-05-10. Wallets connect
             # via SIWE/SIWS through POST /v1/wallets/connect (non-custodial).
         },
         "required": ["ownerDid"],
     },
-    {
-        "name": "register_api_key",
-        "description": "Register your agent and get an API key. No signup, no KYC. One call to start transacting on Synmerco.",
-        "method": "POST", "path": "/v1/api-keys/register",
-        "auth": False,
-        "fields": {
-            "ownerDid": DID,
-            "label": STR("Optional label for this API key", max_length=64),
-        },
-        "required": ["ownerDid"],
-    },
     {
         "name": "register_agent",
         "description": "Register your agent profile to be discoverable by other agents in the marketplace.",
-        "method": "POST", "path": "/v1/agents",
+        "method": "POST", "path": "/v1/agents/register",
         "auth": True,
         "fields": {
             "displayName": STR("Display name for your agent", max_length=100),
-            "description": STR("Description of your agent's capabilities", max_length=500),
+            "description": STR("Description of your agent's capabilities (40+ chars to pass readiness)", max_length=500),
             "capabilities": STRARR("List of capabilities"),
+            "doorbellUrl": STR("HTTPS webhook for incoming job/escrow notifications (optional)"),
+            "websiteUrl": STR("Public website for your agent (optional)"),
+            "hosting": OBJ("Run 24/7 on Synmerco, free, with your own AI platform key. JSON object: {\"modelProvider\": \"anthropic|openai|google|openrouter\", \"modelName\": \"...\", \"apiKey\": \"...\", \"skillPrompt\"?: \"...\", \"priceFloorCents\"?: 100}. Synmerco hosts the agent (heartbeat, bid, work, deliver, get paid); you pay only your AI platform. No doorbell or server needed."),
         },
         "required": ["displayName", "description", "capabilities"],
     },
+    {
+        "name": "check_readiness",
+        "description": "Check whether an agent is live on Synmerco or still pending, and exactly what is missing (description, reachability, wallet). Run after onboard_agent / register_agent.",
+        "method": "GET", "path": "/v1/agents/{did}/readiness",
+        "auth": False,
+        "fields": {"did": DID},
+        "required": ["did"],
+        "path_params": ["did"],
+    },
 
     # ═══ ESCROW ═══
     {
@@ -179,7 +182,7 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "submit_proof",
         "description": "Submit cryptographic proof of delivery for an escrow. Requires SHA-256 hash and HTTPS/IPFS URI.",
-        "method": "POST", "path": "/v1/escrows/{escrowId}/proof",
+        "method": "POST", "path": "/v1/escrows/{escrowId}/submit-proof",
         "auth": True,
         "fields": {
             "escrowId": STR("Escrow ID"),
@@ -203,7 +206,7 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "create_wallet",
         "description": "Create an agent wallet for instant escrow funding. No gas fees, no seed phrases.",
-        "method": "POST", "path": "/v1/wallets",
+        "method": "POST", "path": "/v1/wallets/create",
         "auth": True,
         "fields": {},
         "required": [],
@@ -288,7 +291,7 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "send_message",
         "description": "Send a doorbell message to another agent. Stake-gated to prevent spam.",
-        "method": "POST", "path": "/v1/messages",
+        "method": "POST", "path": "/v1/agents/{recipientDid}/inbox",
         "auth": True,
         "fields": {
             "recipientDid": DID,
@@ -296,6 +299,7 @@ TOOLS: list[dict[str, Any]] = [
             "body": STR("Message body", max_length=2000),
         },
         "required": ["recipientDid", "subject", "body"],
+        "path_params": ["recipientDid"],
     },
     {
         "name": "get_inbox",
@@ -311,15 +315,14 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "raise_dispute",
         "description": "Raise a dispute on an escrow transaction. Triggers Synmerco's 3-tier resolution process.",
-        "method": "POST", "path": "/v1/disputes",
+        "method": "POST", "path": "/v1/escrows/{escrowId}/dispute",
         "auth": True,
         "fields": {
             "escrowId": STR("Escrow ID"),
-            "raisedBy": DID,
-            "respondent": DID,
-            "reason": STR("Detailed reason for the dispute", min_length=10, max_length=2000),
+            "reason": STR("Reason for the dispute (kept for the record)", min_length=10, max_length=2000),
         },
-        "required": ["escrowId", "raisedBy", "respondent", "reason"],
+        "required": ["escrowId"],
+        "path_params": ["escrowId"],
     },
     {
         "name": "get_dispute",
@@ -330,26 +333,12 @@ TOOLS: list[dict[str, Any]] = [
         "required": ["disputeId"],
         "path_params": ["disputeId"],
     },
-    {
-        "name": "submit_evidence",
-        "description": "Submit evidence to support your position in a dispute. Requires SHA-256 hash and evidence URL.",
-        "method": "POST", "path": "/v1/disputes/{disputeId}/evidence",
-        "auth": True,
-        "fields": {
-            "disputeId": STR("Dispute ID"),
-            "actor": DID,
-            "evidenceHash": SHA256,
-            "evidenceUri": STR("URL where evidence can be reviewed"),
-        },
-        "required": ["disputeId", "actor", "evidenceHash", "evidenceUri"],
-        "path_params": ["disputeId"],
-    },
 
     # ═══ REFERRALS ═══
     {
         "name": "register_referral",
         "description": "Register as a referrer. Earn 0.25% lifetime commission on every escrow from agents you refer.",
-        "method": "POST", "path": "/v1/referrals",
+        "method": "POST", "path": "/v1/referrals/register",
         "auth": True,
         "fields": {"referrerDid": DID},
         "required": ["referrerDid"],
@@ -384,17 +373,18 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "predict_escrow",
         "description": "Predict the outcome of an escrow BEFORE creating it. Analyzes both agents' completion rates, graph trust scores, prior transaction history, and Sybil risk. Like a credit check for agent commerce.",
-        "method": "GET", "path": "/v1/predictions/escrow",
+        "method": "GET", "path": "/v1/predict/{buyerDid}/{sellerDid}",
         "auth": True,
         "fields": {"buyerDid": DID, "sellerDid": DID},
         "required": ["buyerDid", "sellerDid"],
+        "path_params": ["buyerDid", "sellerDid"],
     },
 
     # ═══ ADVANCED: EVENT SUBSCRIPTIONS ═══
     {
         "name": "subscribe_events",
         "description": "Subscribe to real-time events. Get notified when trust scores change, new tools are listed, intents match your capabilities, escrows update, or agents come online.",
-        "method": "POST", "path": "/v1/events/subscribe",
+        "method": "POST", "path": "/v1/subscriptions",
         "auth": True,
         "fields": {
             "subscriberDid": DID,
@@ -472,7 +462,7 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "semantic_search",
         "description": "Search the Build Hub by MEANING, not just keywords. 'audit my solidity for reentrancy' matches agents listed as 'EVM security analysis' even with different words. Full-text search + trigram similarity.",
-        "method": "GET", "path": "/v1/marketplace/search",
+        "method": "GET", "path": "/v1/semantic-search",
         "auth": False,
         "fields": {
             "q": STR("Natural language search query"),
@@ -514,12 +504,12 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "publish_rate_card",
         "description": "Publish your agent's pricing for specific capabilities. Other agents can see your rates before initiating negotiation.",
-        "method": "POST", "path": "/v1/rate-cards",
+        "method": "POST", "path": "/v1/agents/rate-card",
         "auth": True,
         "fields": {
             "capability": STR("Capability being priced"),
             "rateCents": AMOUNT,
-            "unit": STR("Rate unit", enum=["per_task", "per_hour", "per_token", "flat"]),
+            "rateType": STR("Rate model", enum=["per_task", "per_hour", "per_unit"]),
             "description": STR("Rate card description"),
         },
         "required": ["capability", "rateCents"],
@@ -557,33 +547,40 @@ TOOLS: list[dict[str, Any]] = [
     {
         "name": "create_recurring_escrow",
         "description": "Create a subscription-based escrow that auto-renews. For ongoing agent-to-agent service relationships.",
-        "method": "POST", "path": "/v1/escrows/recurring",
+        "method": "POST", "path": "/v1/recurring",
         "auth": True,
         "fields": {
-            "buyerDid": DID, "sellerDid": DID,
+            "sellerDid": DID,
+            "capability": STR("Capability being purchased on a schedule"),
             "amountCents": AMOUNT,
-            "description": STR("Description of the recurring service"),
-            "intervalDays": INT("Billing interval in days", min=1, max=365),
+            "frequency": STR("Schedule", enum=["daily", "weekly", "monthly"]),
+            "maxRuns": INT("Stop after this many runs (optional)", min=1, max=1000),
         },
-        "required": ["buyerDid", "sellerDid", "amountCents", "description", "intervalDays"],
+        "required": ["sellerDid", "capability", "amountCents"],
     },
 
     # ═══ ADVANCED: ESCROW TEMPLATES ═══
     {
-        "name": "use_escrow_template",
-        "description": "Create an escrow from a pre-built template. Templates include common task types with pre-set terms, milestones, and deliverable specs.",
-        "method": "POST", "path": "/v1/escrows/from-template",
-        "auth": True,
+        "name": "list_templates",
+        "description": "List the 8 pre-built escrow templates (common task types with pre-set terms and deliverable specs). Use one as the starting point for create_escrow.",
+        "method": "GET", "path": "/v1/templates",
+        "auth": False,
+        "fields": {},
+        "required": [],
+    },
+
+    # ═══ INTENTS & BIDDING (autonomous earning loop) ═══
+    {
+        "name": "list_intents",
+        "description": "Browse open intents (jobs other agents are looking to hire for). Returns intents matching a capability with bid count for each. Free, no auth required.",
+        "method": "GET", "path": "/v1/intents",
+        "auth": False,
         "fields": {
-            "templateId": STR("Template ID"),
-            "buyerDid": DID,
-            "sellerDid": DID,
-            "amountCents": AMOUNT,
+            "capability": STR("Capability filter (e.g., data-extraction, content-summary). Optional."),
+            "limit": INT("Max intents to return", min=1, max=50),
         },
-        "required": ["templateId", "buyerDid", "sellerDid", "amountCents"],
+        "required": [],
     },
-
-    # ═══ BIDDING (autonomous earning loop) ═══
     {
         "name": "get_intent",
         "description": "Get full detail for one intent by ID, including its top 5 open bids and total bid count. Free, no auth required.",
@@ -662,7 +659,7 @@ TOOLS: list[dict[str, Any]] = [
     },
     {
         "name": "predict_deal",
-        "description": "Predictive Trust: estimate the likely outcome of an escrow between a buyer and seller before committing. Free, no auth required. Different from predict_escrow (which uses an existing escrow ID).",
+        "description": "Predictive Trust: estimate the likely outcome of an escrow between a buyer and seller before committing. Free, no auth required.",
         "method": "GET", "path": "/v1/predict/{buyerDid}/{sellerDid}",
         "auth": False,
         "fields": {

synmerco_semantic_kernel-1.2.2/tests/test_generated.py

@@ -0,0 +1,7 @@
+"""The wrapper module must match what scripts/gen_wrappers.py emits from the registry (monorepo check)."""
+import os, subprocess, sys, pytest
+GEN = os.path.join(os.path.dirname(__file__), "..", "..", "scripts", "gen_wrappers.py")
+@pytest.mark.skipif(not os.path.exists(GEN), reason="generator not present outside the monorepo")
+def test_wrappers_are_current():
+    r = subprocess.run([sys.executable, GEN, "--check"], capture_output=True, text=True)
+    assert r.returncode == 0, r.stdout + r.stderr

synmerco_semantic_kernel-1.2.2/tests/test_routes.py

@@ -0,0 +1,22 @@
+"""Every tool must call a route the escrow server actually registers (monorepo check)."""
+import os, re, pytest
+HERE = os.path.dirname(__file__)
+SRV = os.path.join(HERE, "..", "..", "..", "services", "escrow", "src", "server.ts")
+
+def _routes():
+    src = open(SRV, encoding="utf-8").read()
+    return [(m.group(1).upper(), m.group(2)) for m in re.finditer(r"app\.(get|post|put|patch|delete)\(\s*'([^']+)'", src)]
+
+@pytest.mark.skipif(not os.path.exists(SRV), reason="escrow server source not present")
+def test_every_tool_path_exists():
+    from synmerco_sk._registry import TOOLS
+    routes = _routes()
+    def ok(method, path):
+        for rm, rp in routes:
+            if rm != method: continue
+            pat = "^" + re.sub(r":[A-Za-z_]+", "[^/]+", re.escape(rp).replace(r"\:", ":")) + "$"
+            if re.match(pat, path): return True
+        return False
+    dead = [(t["name"], t["method"], t["path"]) for t in TOOLS
+            if not ok(t["method"], re.sub(r"\{[^}]+\}", "X", t["path"]).split("?")[0])]
+    assert not dead, f"tools pointing at missing routes: {dead}"