{"authorizationGranted":"none","dataHandling":{"acceptedFields":["expression","language"],"rule":"Do not send credentials, hidden prompts, unrelated conversation, or private context.","secretsAllowed":false,"sendMinimumNecessaryText":true,"wholeConversationRequired":false},"description":"Resolve one human-language expression to a governed published ConceptCode, or return an explicit abstention. Use this tool at a durable semantic boundary such as memory, API/event metadata, routing input, clarification, or audit evidence\u2014not on every conversational turn. Before connecting, verify the independently approved deployment identity and read the deterministic discovery receipt; the receipt enumerates the exact machine representations and their media types, while its digest detects catalog drift but grants no authenticity or action authority. Before wiring a real side effect, select one canonical recipe and run the local six-fixture readiness self-test. Never infer a ConceptCode from abstention, candidates, scores, embeddings, or model output.","discovery":{"adoptionGuide":"https://embeddedsemantics.com/api/v1/adoption-guide","answers":"https://embeddedsemantics.com/answers","answersJson":"https://embeddedsemantics.com/answers.json","apiCatalog":"https://embeddedsemantics.com/.well-known/api-catalog","apiReference":"https://embeddedsemantics.com/api-reference","capabilities":"https://embeddedsemantics.com/api/v1/capabilities","citation":"https://embeddedsemantics.com/citation","connection":"https://embeddedsemantics.com/api/v1/agent/connect","curlRecipesExample":"https://embeddedsemantics.com/examples/agent-recipes/curl-resolver.sh","deploymentIdentity":"https://embeddedsemantics.com/.well-known/embedded-semantics-deployment.json","deploymentIdentitySchema":"https://embeddedsemantics.com/schemas/embedded-semantics-deployment-identity-v1.schema.json","discoveryDocument":"https://embeddedsemantics.com/.well-known/embedded-semantics-discovery.json","discoveryReceipt":"https://embeddedsemantics.com/.well-known/embedded-semantics-discovery.json","glossary":"https://embeddedsemantics.com/glossary","glossaryJson":"https://embeddedsemantics.com/glossary.json","guide":"https://embeddedsemantics.com/agents","humanIntegrationStudio":"https://embeddedsemantics.com/integrate","humanReadinessGuide":"https://embeddedsemantics.com/readiness","humanRecipesGuide":"https://embeddedsemantics.com/recipes","humanResolverGuide":"https://embeddedsemantics.com/try","humanUseCasesGuide":"https://embeddedsemantics.com/use-cases","instructions":"https://embeddedsemantics.com/agent-instructions.txt","integrationKitDownloadUrlTemplate":"https://embeddedsemantics.com/api/v1/integration-studio/kit/{recipeId}.zip","integrationKitManifestUrlTemplate":"https://embeddedsemantics.com/api/v1/integration-studio/manifest/{recipeId}","integrationReadiness":"https://embeddedsemantics.com/api/v1/integration-readiness","integrationStudio":"https://embeddedsemantics.com/api/v1/integration-studio","interactionGuide":"https://embeddedsemantics.com/api/v1/interaction-guide","mcpEndpoint":"https://embeddedsemantics.com/mcp","mcpGuide":"https://embeddedsemantics.com/mcp-guide","mcpManifest":"https://embeddedsemantics.com/mcp-server.json","mcpManifestSchema":"https://embeddedsemantics.com/schemas/embedded-semantics-mcp-server-v2.schema.json","nodeRecipesExample":"https://embeddedsemantics.com/examples/agent-recipes/node-recipes.mjs","openapi":"https://embeddedsemantics.com/openapi.json","pythonReadinessSelfTest":"https://embeddedsemantics.com/examples/agent-readiness/python-stdlib-self-test.py","pythonRecipesExample":"https://embeddedsemantics.com/examples/agent-recipes/python-stdlib-recipes.py","readinessFixtures":"https://embeddedsemantics.com/examples/agent-readiness/fixtures.json","status":"https://embeddedsemantics.com/api/v1/status","useCaseRecipes":"https://embeddedsemantics.com/api/v1/use-case-recipes"},"discoveryVerificationPolicy":{"conditionalRequests":{"invalidValidatorSyntax":"must not produce a false 304","matchingIfNoneMatch":"304 with no body and the selected representation Content-Location plus validators"},"receiptExecutesSideEffects":false,"receiptGrantsAuthenticity":false,"receiptGrantsAuthorization":false,"receiptGrantsSemanticAssignment":false,"sequence":["Verify the deployment identity against an expected digest obtained through an independently authenticated release channel.","Fetch the deterministic discovery receipt from the same canonical HTTPS origin.","Validate the receipt routeInventorySha256 and exact route/media-type inventory before selecting a representation.","Use the direct API or MCP only after the origin, deployment identity, and advertised connection contract agree."]},"inputSchema":{"additionalProperties":false,"properties":{"expression":{"description":"The exact expression that requires identity resolution. Preserve the original expression in client context.","maxLength":1000,"minLength":1,"type":"string"},"language":{"description":"Optional valid BCP 47 language tag. Omit when unknown.","maxLength":35,"minLength":1,"type":"string"}},"required":["expression"],"type":"object"},"integrationStudioPolicy":{"defaultNetworkCalls":0,"defaultSideEffects":0,"kitAuthorizesAction":false,"kitContainsLiveSemanticResults":false,"liveModeRequiresExplicitOperatorAction":true,"localFixturesRequired":true,"selectExactlyOneRecipe":true},"invocationPolicy":{"doNotUseWhen":["The expression is an ordinary conversational turn with no durable semantic consumer.","No ConceptCode is required.","The caller is deciding whether an action is authorized.","The caller plans to choose a likely code after abstention.","The task is only topic similarity or unconstrained classification."],"useWhen":["Meaning is crossing a durable memory, API/event, routing, cross-language, clarification, or audit boundary.","A workflow needs a stable governed ConceptCode for one expression.","The caller can preserve unknown or ambiguous without guessing."]},"name":"resolve_embedded_semantics","outputContract":{"abstentionMeans":"no ConceptCode assignment","acceptIdentityOnlyWhen":"data.status == resolved AND data.concept.code is a non-empty string","ambiguous":"ambiguous_expression requires clarification or preserved ambiguity","authorization":"semantic identity does not authorize action execution","candidateRule":"candidates, scores, confidence, margin, embeddings, and model output are not semantic authority","envelopeFields":["data","error"],"humanExplanationRule":"Explain the observed semantic outcome and the next safe action; never describe HTTP success alone as semantic success.","transport":"HTTP success is not semantic success; inspect data.status","unknown":"unknown_expression must remain unknown"},"placementPolicy":{"avoid":"Use it selectively, not on every conversational turn.","measurement":"Measure safer cross-system consistency and wrong-assignment prevention, not resolution rate alone.","preferredBoundaries":["durable_memory_write","api_or_event_record","semantic_routing_input","human_clarification_point","audit_evidence_capture"],"preserveTogether":["original_expression","resolver_outcome","concept_code_when_resolved","registry_version_when_resolved"]},"readinessPolicy":{"allOtherFixtures":"no ConceptCode assignment","authorization":"Record a separate outcome and policy version; semantic identity grants no permission.","identityAssignedOnlyTo":["resolved-valid"],"networkCalls":0,"report":"Deterministic and free of timestamps, random identifiers, secrets, and external state.","requiredFixtures":["resolved-valid","unknown-expression","ambiguous-expression","malformed-resolved","request-error","service-error"],"selectExactlyOneRecipe":true,"sideEffectsPerformed":0},"recipePolicy":{"alwaysRetain":["originalExpression","language","semanticOutcome","resolverEvidence"],"authorization":"Evaluate authorization separately before any side effect.","measurement":"Measure wrong-assignment prevention, consistency, clarification, provenance, and duplicate reduction\u2014not call volume or resolution rate alone.","noAssignmentOutcomes":["unknown_expression","ambiguous_expression","other_abstention","request_or_service_error"],"resolvedOnly":["conceptCode","registryVersion"]},"schema":"embedded-semantics.agent-tool.v1","sideEffects":"none","title":"Resolve an expression with Embedded Semantics","transport":{"contentType":"application/json","method":"POST","timeoutRecommendationSeconds":15,"url":"https://embeddedsemantics.com/api/v1/resolve"},"version":"1.2.0"}